Mensagens

Todo envio de WhatsApp sai por uma única ação, send_message, dentro do endpoint POST /conversation/actions. Uma mesma ação cobre os quatro modos —texto, mídia, resposta rápida e template—; qual você pode usar depende do estado da janela de 24h da conversa.

Qual modo se aplica conforme a janela

Modo	Janela aberta	Janela fechada
Texto	✅	❌ `WINDOW_CLOSED`
Mídia	✅	❌ `WINDOW_CLOSED`
Resposta rápida	✅	❌ `WINDOW_CLOSED`
Template	✅	✅ — reabre a janela

O template é a única mensagem que você pode enviar com a janela fechada. Além disso, enviá-lo reabre a janela, habilitando texto, mídia e resposta rápida novamente.

Os quatro modos de `send_message`

Cada send_message envia um único tipo de conteúdo: texto (body), mídia (file_uuid), uma resposta rápida (quick_reply) ou um template (template). Os três primeiros admitem ainda um template de fallback para quando a janela está fechada (ver abaixo).

Texto
Mídia
Resposta rápida
Template

Texto livre, até 4096 caracteres.

{
  "type": "send_message",
  "body": "Olá 👋, como posso ajudar?"
}

Imagem, vídeo, áudio ou documento: passe um file_uuid de um arquivo já enviado e confirmado, com body como legenda opcional. O tipo é deduzido do arquivo; áudio não admite legenda. O fluxo de upload está em Enviar mídia.

{
  "type": "send_message",
  "file_uuid": "7b8a1c2d-3e4f-5678-90ab-cdef12345678",
  "body": "Aqui está o seu comprovante 📄"
}

Uma resposta pré-configurada no dashboard, identificada por name (sem distinguir maiúsculas). Pode emitir várias mensagens.

{
  "type": "send_message",
  "quick_reply": { "name": "Boas-vindas" }
}

Um template aprovado pelo Meta — o único modo que funciona com a janela fechada. language é obrigatório (formato Meta lower_UPPER, ex. pt_BR). Veja Templates.

{
  "type": "send_message",
  "template": {
    "name": "confirmacao_consulta",
    "language": "pt_BR",
    "body_variables": [{ "index": 1, "value": "Ana" }]
  }
}

Enviar

O envio é uma ação dentro do grupo. Faça um POST /conversation/actions com um send_message no array actions:

curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/actions" \
  -H "Authorization: Bearer sk_1to1_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": {
      "phone": "+5215512345678",
      "channel": "ch_7A9K2M4Q"
    },
    "actions": [
      {
        "type": "send_message",
        "body": "Olá 👋, como posso ajudar?"
      }
    ]
  }'

Responde 202: o envio corre em background. Consulte o resultado no estado da conversa ou no activity log. Para encadear vários envios ou outras ações em um mesmo request, veja Ações.

Fallback de template para a janela fechada

Um send_message de texto, mídia ou resposta rápida pode incluir ainda um template opcional: se ao executar a janela estiver fechada, envia-se o template em vez do primário; se estiver aberta, envia-se o primário. Sem template, um primário com a janela fechada falha com WINDOW_CLOSED.

curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/actions" \
  -H "Authorization: Bearer sk_1to1_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": {
      "phone": "+5215512345678",
      "channel": "ch_7A9K2M4Q"
    },
    "actions": [
      {
        "type": "send_message",
        "body": "Olá 👋",
        "template": {
          "name": "lembrete",
          "language": "pt_BR"
        }
      }
    ]
  }'

Introdução

Conceitos

Guias

Ações

Qual modo se aplica conforme a janela

Os quatro modos de `send_message`

Enviar

Fallback de template para a janela fechada

Próximos passos

Templates

Ações

​Qual modo se aplica conforme a janela

​Os quatro modos de send_message

​Enviar

​Fallback de template para a janela fechada

​Próximos passos

Templates

Ações

Qual modo se aplica conforme a janela

Os quatro modos de `send_message`

Enviar

Fallback de template para a janela fechada

Próximos passos