Mensagens de resposta enviadas pelo WhatsApp

As respostas de saída do WhatsApp permitem que as empresas citem ou respondam a uma mensagem existente em uma conversa. Pode ser tanto uma mensagem de um usuário final quanto uma mensagem enviada pela própria empresa. Isso dá à empresa a possibilidade de fornecer contexto adicional ao enviar uma mensagem, a fim de trazer clareza que o conteúdo da mensagem por si só talvez não consiga transmitir.

As empresas podem citar/responder a:

• Mensagem de um usuário final. Isso poderia ser usado para deixar claro que a última mensagem enviada pela empresa se refere a um específico mensagem do usuário no início da conversa, por exemplo: “Com relação ao que você perguntou aqui, a resposta é...”
• Uma mensagem enviada pela empresa. Isso pode ser usado para se referir a algo que a própria empresa mencionou anteriormente na conversa, por exemplo: “Essa é a opção a que eu me referia”.

Na interface do WhatsApp, o destinatário receberá a nova mensagem acompanhada de um balão contextual que exibe o conteúdo da mensagem anterior.

Carga útil da solicitação de API

Para enviar uma mensagem de resposta de saída, além dos campos padrão do tipo de mensagem do WhatsApp que está sendo enviada, a carga JSON da solicitação à API precisa incluir um elemento de nível superior context propriedade. O valor dessa propriedade é um objeto com uma propriedade message_uuid, cujo valor é o UUID da mensagem citada ou à qual se está respondendo.

Um exemplo de payload JSON poderia ser algo assim:

{
	"to": "447700900000",
	"from": "447700900001",
	"channel": "whatsapp",
	"message_type": "text",
	"text": "This looks like your order number. Can you confirm?",
	"context": {
		"message_uuid": "a1b2c3d4a1b2c3d4"
	}
}

Limitações

• Esse recurso está disponível em API na nuvem apenas WABAs hospedadas (ver Hospedagem de números do WhatsApp)
• As respostas devem ser enviadas no prazo de 30 dias a partir da data de recebimento ou envio da mensagem original citada ou à qual se responde.

Erros possíveis

As tentativas de responder a uma mensagem que não está armazenada — seja porque ela não existe ou porque o prazo de 30 dias já expirou — resultarão na rejeição da mensagem com o seguinte código de erro:

1451 - Invalid context - the reference to the original message could not be found because it is invalid or no longer available