Enviar mensajes de texto

Puedes utilizar el nodo messages para enviar mensajes de texto a tus clientes.

Antes de empezar

Debes cumplir todos los requisitos que se indican en la sección Antes de empezar de la documentación de Mensajes.

Restricciones:

• Un mensaje de texto puede tener 4096 caracteres como máximo.

Paso 1: Realizar una solicitud POST a /messages

Cuando tengas el identificador de WhatsApp del usuario al que quieres enviar un mensaje, utilízalo para enviarle un mensaje de texto. Especifica text en el campo type.

POST /v1/messages
{
    "preview_url": false | true,
    "recipient_type": "individual",
    "to": "whatsapp-id",
    "type": "text",
    "text": {
        "body": "your-text-message-content"
    }
}

Para obtener más información sobre los parámetros, consulta:

• Parámetros comunes en todas las solicitudes de mensajes
• Parámetros para mensajes de texto

Si quieres dar formato al mensaje, consulta Aplicar formato en los mensajes de texto.

Enviar direcciones URL en los mensajes de texto

De manera predeterminada, la aplicación WhatsApp móvil reconoce las URL y hace que sean interactivas. Para incluir la vista previa de una URL, incluye "preview_url": true en el cuerpo del mensaje y asegúrate de que la URL empieza por http:// o https://. La aplicación solo reconoce como interactivas las URL que correspondan a nombres de host, no las direcciones IP.

Ten en cuenta que el uso de preview_url aquí no es igual que en la API de nube. Consulta la documentación de Mensajes de la API de nube.

Ejemplo

{
    "preview_url": true,
    "to": "whatsapp-id",
    "text": {
        "body": "You have to check out this amazing messaging service https://www.whatsapp.com/"
     }

La mayoría de las veces, cuando envíes una URL, ya sea con o sin vista previa, el receptor del mensaje verá una URL en la que podrá hacer clic.

Las vistas previas de URL solo se muestran en las siguientes situaciones:

1. La empresa ha enviado una plantilla de mensaje al usuario.
2. El usuario inicia una conversación con un enlace de “clic para chatear”.
3. El usuario añade el número de teléfono de la empresa a su libreta de direcciones e inicia una conversación.

Paso 2: Comprobar la respuesta

Una respuesta correcta incluye un objeto messages con un identificador del mensaje recién creado.

{
  "messages": [{
    "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
  }]
}  

Una respuesta incorrecta contiene un mensaje de error. Consulta Códigos de error y de estado para obtener más información.