> ## 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.

# Multicanal

> Combine vários canais (e-mail, SMS, WhatsApp, voz e carta) em uma única requisição.

A AR Online permite **disparar vários canais numa só requisição**, usando o endpoint `POST /gw/email`.

## Envio multicanal

Para acionar mais de um canal no mesmo envio, basta incluir os blocos correspondentes (`sms`, `whatsapp`, `voz`, `carta`) na requisição. Cada bloco presente ativa o seu canal, de forma **independente**. O e-mail entra como mais um canal — disparado quando você informa o destinatário (`to`). A requisição abaixo combina **e-mail + SMS + WhatsApp + Voz + Carta**.

<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": "Documento Importante",
      "content": "<p><strong>Você recebeu um documento importante.</strong></p>",
      "attachments": [
        {
          "name": "documento.pdf",
          "base64": "iVBORw0KGgoAAAANSUhEUgAAAAoAAAABCAQAAABN/Pf1AAAADUlEQVR42mNk+M+AAQATFwEB/YopsAAAAABJRU5ErkJggg=="
        }
      ],
      "sms": {
        "number": "119999988888",
        "typeSend": "1",
        "customMessage": "Você recebeu um AR-Email. Acesse: {SHORT_LINK}"
      },
      "whatsapp": { "number": "11999999888" },
      "voz": {
        "number": "11999999888",
        "template": "template_voz_padrao",
        "payload": {
          "OPERADORA_VOZ": "A R SAÚDE",
          "NOME_VOZ": "João da Silva"
        }
      },
      "carta": {
        "name": "teste-carta-padrao",
        "modelo": "modelo-teste-padrao.docx",
        "variables": {
          "TEMPLATE_CARTAS": "modelo-teste-padrao.docx",
          "NOME_DESTINATARIO_CARTA": "João da Silva",
          "CIDADE_CARTA": "SÃO PAULO",
          "ESTADO_CARTA": "SP",
          "CEP_CARTA": "99999000"
        }
      }
    }'
  ```

  ```json Body completo theme={null}
  {
    "nameTo": "João da Silva",
    "to": "joao@exemplo.com",
    "subject": "Documento Importante",
    "content": "<p><strong>Você recebeu um documento importante.</strong></p>",
    "attachments": [
      {
        "name": "documento.pdf",
        "base64": "iVBORw0KGgoAAAANSUhEUgAAAAoAAAABCAQAAABN/Pf1AAAADUlEQVR42mNk+M+AAQATFwEB/YopsAAAAABJRU5ErkJggg=="
      }
    ],
    "sms": {
      "number": "119999988888",
      "typeSend": "1",
      "customMessage": "Você recebeu um AR-Email. Acesse: {SHORT_LINK}"
    },
    "whatsapp": { "number": "11999999888" },
    "voz": {
      "number": "11999999888",
      "template": "template_voz_padrao",
      "payload": {
        "OPERADORA_VOZ": "A R SAÚDE",
        "NOME_VOZ": "João da Silva",
        "CONTATO_OPERADORA_VOZ": "zero oitocentos, um, dois, três, quatro, três, dois ",
        "CPF2_DIGITOS_FINAL_VOZ": "7 8",
        "CPF3_DIGITOS_INICIAL_VOZ": "123",
        "DESCRICAO_COMPENTECIA_VOZ": "Janeiro a Março de 2024",
        "RESULTADO_CONFIRMACAO_VOZ": "123"
      }
    },
    "carta": {
      "name": "teste-carta-padrao",
      "modelo": "modelo-teste-padrao.docx",
      "variables": {
        "TEMPLATE_CARTAS": "modelo-teste-padrao.docx",
        "ASSUNTO_CARTA": "JOÃO DA SILVA - Teste de envio AR-Cartas",
        "NOME_DESTINATARIO_CARTA": "João da Silva",
        "LOGRADOURO_CARTA": "RUA SEM SAIDA",
        "COMPLEMENTO_CARTA": "Casa",
        "NUMERO_CARTA": 99,
        "BAIRRO_CARTA": "CENTRO",
        "CIDADE_CARTA": "SÃO PAULO",
        "ESTADO_CARTA": "SP",
        "CEP_CARTA": "99999000"
      }
    }
  }
  ```
</CodeGroup>

A resposta segue sendo um único `idEmail`, que cobre todos os canais do envio:

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

<Note>
  Cada canal tem seus próprios pré-requisitos. Consulte cada guia: [E-mail](/enviando/email), [SMS](/enviando/sms), [WhatsApp](/enviando/whatsapp), [Voz](/enviando/voz) e [Carta](/enviando/carta).
</Note>