Mensagens

A API oferece quatro formas de enviar uma mensagem de WhatsApp em nome do seu negócio. Qual delas 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`
Quick reply	✅	❌ `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 quick reply novamente.

As quatro formas de enviar

Texto
Mídia
Quick reply
Template

Texto livre, até 4096 caracteres, via POST /conversation/messages/text.

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

Aceita um reply_to_uuid opcional para citar uma mensagem anterior. Responde 201 com message_uuid e wamid.

Imagem, vídeo, áudio ou documento — mesmo endpoint que texto (POST /conversation/messages/text), passando um file_uuid em vez de —ou junto a— body como legenda.

curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/text" \
  -H "Authorization: Bearer sk_1to1_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": { "phone": "+5215512345678" },
    "file_uuid": "7b8a...",
    "body": "Aqui está o seu comprovante 📄"
  }'

O file_uuid deve ser de um arquivo já enviado e confirmado, do mesmo negócio. O tipo de mensagem (imagem, vídeo, áudio, documento) é deduzido automaticamente do arquivo. Veja o fluxo de /files na Referência da API.

Uma resposta pré-configurada no dashboard, via POST /conversation/messages/quick-reply. É identificada por quick_reply_uuid ou por quick_reply.name.

curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/quick-reply" \
  -H "Authorization: Bearer sk_1to1_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": { "phone": "+5215512345678" },
    "quick_reply": { "name": "Boas-vindas" }
  }'

Uma quick reply pode emitir várias mensagens, por isso a resposta é um array messages com um message_uuid, wamid e subtype para cada uma.

Um template aprovado pelo Meta, via POST /conversation/messages/template. É o único modo que funciona com a janela fechada — veja Templates para o detalhe.

curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/template" \
  -H "Authorization: Bearer sk_1to1_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": { "phone": "+5215512345678" },
    "template_name": "confirmacao_consulta",
    "body_variables": [
      { "index": 1, "value": "Ana" }
    ]
  }'

Responde 201 com message_uuid e wamid.

Próximos passos

Templates

Criar e enviar templates para reabrir a janela.

Conversas

Identificadores e a janela de 24h em detalhe.

Introdução

Conceitos

Guias

Referência da API

Qual modo se aplica conforme a janela

As quatro formas de enviar

Próximos passos

Templates

Conversas

Introdução

Conceitos

Guias

Referência da API

Documentation Index

​Qual modo se aplica conforme a janela

​As quatro formas de enviar

​Próximos passos

Templates

Conversas

Qual modo se aplica conforme a janela

As quatro formas de enviar

Próximos passos