POST /chats/:chatId

Autenticação

A rota exige um token válido no cabeçalho Authorization e o cabeçalho X-Token-Type com valor external-app. Sem autenticação, a requisição será bloqueada.

Authorization: Bearer <SEU_TOKEN_DE_ACESSO>
Content-Type: application/json
X-Token-Type: external-app

Parâmetros de rota

Corpo da requisição

O JSON precisa conter o nome do template, o idioma e os componentes opcionais do template.

{
  "language": "pt_BR",
  "template": "nome_do_template",
  "components": null
}

Fluxo de processamento

1. Valida o token de autenticação.
2. Procura o chat informado por chatId.
3. Se o chat não existir, procura um contato com o mesmo identificador.
4. Se encontrar o contato, cria o chat automaticamente.
5. Valida o corpo da requisição.
6. Envia o template para o WhatsApp.
7. Registra a mensagem no chat.

Exemplo de requisição

curl -X POST "https://api.whatsapp.fluxki.com.br/chats/5511999999999" \
  -H "Authorization: Bearer <SEU_TOKEN_DE_ACESSO>" \
  -H "Content-Type: application/json" \
  -H "X-Token-Type: external-app" \
  -d '{
    "language": "pt_BR",
    "template": "boas_vindas",
    "components": null
  }'

Exemplo com variáveis no template

{
  "language": "pt_BR",
  "template": "agendamento_confirmacao",
  "components": [
    {
      "type": "body",
      "parameters": [
        {
          "type": "text",
          "text": "João"
        },
        {
          "type": "text",
          "text": "15/03/2026"
        }
      ]
    }
  ]
}

O exemplo acima é ilustrativo. A estrutura exata dos componentes depende do template configurado.

Exemplo de resposta de sucesso

{
  "responseAPI": {
    "messages": [
      {
        "id": "wamid.HBgL..."
      }
    ]
  },
  "message": {
    "type": "template",
    "from": "app_user",
    "waId": "wamid.HBgL..."
  }
}

Erros comuns