Mensajes de respuesta salientes de WhatsApp

Las respuestas salientes de WhatsApp permiten a las empresas citar o responder a un mensaje ya existente en una conversación. Puede tratarse tanto de un mensaje de un usuario final como de uno propio. Esto ofrece a la empresa la posibilidad de aportar contexto adicional al enviar un mensaje, con el fin de aportar una mayor claridad que el contenido del mensaje por sí solo quizá no pueda transmitir.

Las empresas pueden citar/responder a:

  • Mensaje de un usuario final. Esto podría utilizarse para dejar claro que el último mensaje enviado por la empresa se refiere a un específico mensaje del usuario anterior en la conversación, por ejemplo: "En referencia a lo que has preguntado aquí, la respuesta es...".
  • Un mensaje enviado por la empresa. Podría utilizarse para hacer referencia a algo que la propia empresa haya mencionado anteriormente en la conversación; por ejemplo: «Esta es la opción a la que me refería».

En la interfaz de usuario de WhatsApp, el destinatario recibirá el nuevo mensaje junto con un globo contextual en el que se muestra el contenido del mensaje anterior.

Screenshot of an outbound reply message in the WhatsApp UI

Carga útil de la solicitud API

Para enviar un mensaje de respuesta saliente, además de los campos estándar correspondientes al tipo de mensaje de WhatsApp que se va a enviar, la carga útil JSON de la solicitud de la API debe incluir un elemento de nivel superior context propiedad. El valor de esta propiedad es un objeto con una propiedad message_uuidcuyo valor es el UUID del mensaje que se está citando/respondiendo.

Una carga útil JSON podría tener un aspecto similar al siguiente:

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

Limitaciones

  • Esta función está disponible en API en la nube sólo WABA alojados (véase Alojamiento de números de WhatsApp)
  • Las respuestas deben realizarse en un plazo de 30 días a partir de la recepción/envío del mensaje original citado/respondido.

Errores potenciales

Los intentos de responder a un mensaje que no está almacenado, ya sea porque no existe o porque ha transcurrido el plazo de 30 días, provocarán el rechazo del mensaje con el siguiente código de error:

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