Envío de mensajes de texto

Puedes usar el nodo messages para enviar mensajes de texto a los clientes.

Antes de empezar

Debes cumplir con todos los requisitos previos que se indican en la sección Antes de empezar de la documentación sobre los mensajes.

Restricciones:

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

Paso 1: Haz una solicitud POST a /messages

Una vez que tengas el identificador de WhatsApp del usuario al que quieres enviar un mensaje, utilízalo para enviar 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 lo siguiente:

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

Si deseas darle formato a tu mensaje, consulta Aplicar formato en mensajes de texto.

Enviar URL en mensajes de texto

De forma predeterminada, la aplicación WhatsApp para celulares reconoce las URL y permite hacer clic en ellas. Para incluir una vista previa de la URL, incluye "preview_url": true en el cuerpo del mensaje y asegúrate de que la URL comienza con http:// o https://. Se debe incluir el nombre de host, ya que las direcciones IP no se reconocen correctamente.

Ten en cuenta que aquí el uso de preview_url es diferente al de la API de la nube. Consulta el documento Mensajes de la API de la 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 parte del tiempo, cuando envías una URL, ya sea con o sin vista previa, el destinatario del mensaje verá una URL en la que puede hacer clic.

Las vistas previas de URL solo se mostrarán después de que se dé alguna de las siguientes situaciones:

1. La empresa envió una plantilla de mensaje al usuario.
2. El usuario inicia una conversación con un enlace "clic para chatear".
3. El usuario agrega el número de teléfono de la empresa a su libreta de direcciones e inicia una conversación.

Paso 2: Verifica la respuesta

Una respuesta exitosa incluye un objeto messages con un identificador para el mensaje creado recientemente.

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

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