Indicadores de respuesta

Los indicadores de respuesta son señales conversacionales que permiten a una parte saber que la otra ha visto un mensaje y ha empezado a preparar una respuesta. Los indicadores de respuesta, que suelen mostrarse en forma de tres puntos animados, mejoran la experiencia conversacional al reducir la incertidumbre y hacer que las interacciones parezcan más naturales y receptivas.

Los indicadores de respuesta sólo están disponibles actualmente para Whatsapp.
Los indicadores de respuesta pueden presentarse en diferentes formatos, incluyendo texto y notas de voz. Las respuestas textuales se conocen como indicadores de mecanografía.

Un indicador de respuesta se desactiva automáticamente cuando se envía un mensaje de respuesta, o después de 25 segundos, lo que ocurra primero. Para evitar una mala experiencia de usuario, envía un indicador de respuesta sólo cuando esperes que te respondan.

Tras recibir un webhook de mensaje entrante, puede utilizar la función message_uuid a:

  • marcar el mensaje como ready
  • mostrar un indicador de respuesta a la otra parte

Este enfoque garantiza que los indicadores de respuesta sean siempre contextuales, oportunos y estén vinculados a un mensaje específico de la conversación.

Para mostrar un indicador de respuesta, envíe una solicitud PATCH al recurso de mensajes identificado por message_uuid.

La petición:

  • actualiza el estado del mensaje a read
  • incluye un replying_indicator objeto que controla si se muestra el indicador y qué tipo de respuesta se está preparando.

Solicitar estructura

curl -X PATCH "${GEOSPECIFIC_MESSAGES_API_URL}/${MESSAGES_MESSAGE_ID}" \
  -H "Authorization: Bearer $JWT" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "status": "read",
    "replying_indicator": {
      "show": "true",
      "type": "text"
    }
  }'
Campo Descripción
status Actualiza el estado del mensaje. Debe estar configurado como leído para habilitar los indicadores de respuesta.
replying_indicator.show Activa o desactiva el indicador de respuesta.
replying_indicator.type Indica el tipo de respuesta que se está preparando (por ejemplo, texto).

Puntos finales de API específicos de la zona geográfica

La Messages API está disponible a través de URLs base geográficas específicas. Debe utilizar el punto final que corresponda a la región en la que está aprovisionada su aplicación:

  • Asia-Pacífico (APAC): https://api-ap.vonage.com/v1
  • Europa (UE): https://api-eu.vonage.com/v1
  • Estados Unidos: https://api-us.vonage.com/v1

En ejemplos, ${GEOSPECIFIC_MESSAGES_API_URL} representa una de estas URL base. Para mostrar un indicador de respuesta, se envía una solicitud

PATCH
al recurso de mensajes identificado por el UUID del mensaje del cliente (message_uuid). Este UUID se proporciona en la carga útil del webhook del mensaje entrante.

ID del mensaje Punto final

El UUID del mensaje se añade a la etiqueta /messages ruta del recurso. Por ejemplo:

https://api-us.vonage.com/v1/messages/3ca4b881-3e11-46bd-b491-76740a62639a

Este UUID identifica de forma única el mensaje entrante del cliente que está marcando como leído y al que está respondiendo.

Respuesta

Cuando tenga éxito:

{
  "success": true
}