As quatro formas de enviar uma mensagem e qual se aplica conforme a janela de 24h.
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.
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.
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.
body (legenda) não é compatível com arquivos de áudio. O WhatsApp não
suporta legendas em áudio — combiná-los retorna INVALID_REQUEST (400).
Uma resposta pré-configurada no dashboard, via
POST /conversation/messages/quick-reply. Identificada por um de
quick_reply_uuid ou quick_reply.name (XOR estrito — enviar ambos
retorna 400 INVALID_REQUEST).
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.
