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.
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.