> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ar-online.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Faça seu primeiro envio na AR Online em poucos minutos: do token à consulta de status.

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

<Steps>
  <Step title="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](mailto:suporte@ar-online.com.br).

    Lembre-se: o token vai **sem o prefixo `Bearer`**. Veja os detalhes em [Autenticação](/autenticacao).
  </Step>

  <Step title="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:

    <ParamField path="nameTo" type="string" required>Nome do destinatário.</ParamField>
    <ParamField path="to" type="string" required>E-mail do destinatário.</ParamField>
    <ParamField path="subject" type="string" required>Assunto da mensagem.</ParamField>
    <ParamField path="content" type="string" required>Conteúdo da mensagem, em HTML.</ParamField>
  </Step>

  <Step title="Envie a requisição">
    Use o exemplo abaixo, substituindo `SEU_TOKEN_AQUI` pelo seu token:

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST "https://api.ar-online.com.br/gw/email" \
        -H "Authorization: SEU_TOKEN_AQUI" \
        -H "Content-Type: application/json" \
        -d '{
          "nameTo": "João da Silva",
          "to": "joao@exemplo.com",
          "subject": "Seu primeiro AR-Email",
          "content": "<p>Olá! Esta é uma notificação de teste enviada pela API da AR Online.</p>"
        }'
      ```

      ```json JSON do corpo theme={null}
      {
        "nameTo": "João da Silva",
        "to": "joao@exemplo.com",
        "subject": "Seu primeiro AR-Email",
        "content": "<p>Olá! Esta é uma notificação de teste enviada pela API da AR Online.</p>"
      }
      ```
    </CodeGroup>
  </Step>

  <Step title="Receba o idEmail">
    Em caso de sucesso, a API responde `HTTP 200` com o identificador do envio:

    ```json theme={null}
    {
      "idEmail": "8c4813f5-8430-4ad4-ab72-19d7eed39731"
    }
    ```

    <Warning>
      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.
    </Warning>
  </Step>

  <Step title="Consulte o status">
    Use o `idEmail` retornado para acompanhar a entrega e a leitura da mensagem. Veja como em [Consultar status](/acompanhando/consultar-status).
  </Step>
</Steps>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Adicione mais canais" href="/enviando/visao-geral" icon="paper-plane">
    Combine e-mail, SMS, WhatsApp, voz e carta em uma única requisição.
  </Card>

  <Card title="Webhooks" href="/webhooks/visao-geral" icon="bell">
    Receba atualizações de status em tempo real, sem precisar consultar.
  </Card>
</CardGroup>