Conceituação
Os endpoints de mensagens desta seção permitem enviar mensagens somente quando a janela de conversa do WhatsApp estiver aberta (dentro do período de 24 horas). Isso é uma regra da API oficial do WhatsApp Business.Dentro da janela (24h)
O cliente enviou uma mensagem para você? Ótimo, a janela está aberta. Você pode usar qualquer endpoint desta seção para responder com texto, imagem, áudio, vídeo, documento, etc.Fora da janela (após 24h)
Se o cliente não enviou uma mensagem nas últimas 24 horas, a única forma de iniciar uma conversa é enviando um template de mensagem previamente aprovado pela Meta. Templates são mensagens pré-definidas que você cria e submete para aprovação no painel da Meta.Na Z-API (conexão não oficial) essa limitação não existia — você podia enviar mensagens a qualquer momento. Na API oficial, essa regra é obrigatória e não pode ser contornada.
Para enviar uma mensagem, você precisa do número do telefone do contato destinatário, incluindo o código do país.
| Formato | Exemplo |
|---|---|
| Código do país + DDD + número | 5511999999999 |
Resposta da API
Ao enviar uma mensagem, a API retorna a mesma estrutura de resposta que você já conhece da Z-API. Isso significa que nenhuma adaptação é necessária no seu código que processa os retornos — os campos, tipos e formatos são idênticos. Exemplo de resposta ao enviar uma mensagem:Mantemos a compatibilidade total com a estrutura de resposta da Z-API. Se a sua aplicação já trata esses campos, ela continuará funcionando sem alterações.
Armazene o messageId
É muito importante que você armazene omessageId retornado, pois ele é necessário para operações futuras como responder, marcar como lida ou deletar mensagens.
Formatação de texto
Você pode formatar o texto das mensagens utilizando caracteres especiais do WhatsApp:| Formatação | Sintaxe | Resultado |
|---|---|---|
| Negrito | *texto* | texto |
| Itálico | _texto_ | texto |
~texto~ | ||
Monoespaçado | ```texto``` | texto |