Skip to main content
Este guia mostra, do início ao fim, como fazer seu primeiro envio de AR-Email pela API da AR Online.
1

Obtenha seu token

A autenticação usa um token enviado no header Authorization. O token de produção é fornecido pela nossa equipe — solicite-o pelo e-mail suporte@ar-online.com.br.Lembre-se: o token vai sem o prefixo Bearer. Veja os detalhes em Autenticação.
2

Monte a requisição

O envio é feito com POST para https://api.ar-online.com.br/gw/email, com os cabeçalhos:
  • Authorization: SEU_TOKEN_AQUI
  • Content-Type: application/json
Para um e-mail simples, o corpo precisa de quatro campos:
string
required
Nome do destinatário.
string
required
E-mail do destinatário.
string
required
Assunto da mensagem.
string
required
Conteúdo da mensagem, em HTML.
3

Envie a requisição

Use o exemplo abaixo, substituindo SEU_TOKEN_AQUI pelo seu token:
4

Receba o idEmail

Em caso de sucesso, a API responde HTTP 200 com o identificador do envio:
O HTTP 200 significa que a requisição foi aceita para processamento, não que a mensagem já foi entregue. O envio é assíncrono. Guarde o idEmail: é com ele que você acompanha o status.
5

Consulte o status

Use o idEmail retornado para acompanhar a entrega e a leitura da mensagem. Veja como em Consultar status.

Próximos passos

Adicione mais canais

Combine e-mail, SMS, WhatsApp, voz e carta em uma única requisição.

Webhooks

Receba atualizações de status em tempo real, sem precisar consultar.