Componentes de conversaciones

Los componentes de conversaciones son funciones internas de los chats que se pueden activar en números de teléfono de empresa. Facilitan a los usuarios de WhatsApp interactuar con tu empresa. Puedes configurar comandos fáciles de usar, proporcionar frases para romper el hielo predefinidas que los usuarios pueden tocar y saludar con un mensaje de bienvenida a los usuarios que utilizan el servicio por primera vez.

Limitaciones

Si un usuario de WhatsApp toca un enlace universal (es decir, un enlace wa.me) configurado con texto rellenado previamente, las interfaces de usuario de las frases para romper el hielo se ignoran automáticamente.

Configurar mediante el Administrador de WhatsApp (WAM)

Puedes configurar todas estas funciones en el Administrador de WhatsApp en los números específicos que elijas:

1. Accede al panel Mis aplicaciones en el sitio de Meta for Developers.
2. Selecciona tu aplicación y, en el panel izquierdo, selecciona Configuración en WhatsApp.
3. En Números de teléfono, selecciona Administrar números de teléfono.
4. A la derecha del número de teléfono que quieras configurar, selecciona el icono de engranaje en Configuración.
5. Selecciona Automatizaciones.
6. Accede a los componentes de conversaciones y configúralos.

Los socios de soluciones también pueden configurar estas funciones para un determinado cliente si tienen acceso a su cuenta de WhatsApp Business en el Administrador de WhatsApp.

Mensajes de bienvenida

Puedes recibir una notificación de webhooks cada vez que un usuario de WhatsApp abra un chat contigo por primera vez. Esto puede ser útil si quieres responder a estos usuarios con un mensaje especial de bienvenida diseñado por ti.

Los mensajes de bienvenida son ideales para las interacciones de servicio, como el servicio de atención al cliente o el servicio de cuentas. Por ejemplo, puedes insertar un botón de WhatsApp en tu aplicación o sitio web. Cuando los usuarios toquen el botón, el sistema los redirigirá a WhatsApp, donde recibirán un mensaje de bienvenida en el que se proporcionará contexto sobre cómo pueden interactuar contigo.

Si activas esta función y un usuario te envía un mensaje, el cliente de WhatsApp comprueba si ya existe una conversación entre el usuario y el número de teléfono de tu empresa. En caso negativo, el cliente activa un webhook messages con el valor de type establecido en request_welcome. Entonces, puedes responder al usuario con tu propio mensaje de bienvenida.

El webhook request_welcome activa un intervalo de servicio de atención al cliente que permite a tu empresa enviar mensajes de formato libre al responder a los clientes.

Mensaje de plantilla de secuencia como mensaje de bienvenida

Carga útil de los webhooks

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_NAME>"
                },
                "wa_id": "<WHATSAPP_USER_ID>"
              }
            ],
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER_ID>",
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<TIMESTAMP>",
                "type": "request_welcome"  // Indicates first time message from WhatsApp user
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Frases para romper el hielo

Las frases para romper el hielo son cadenas de texto personalizables, que se pueden tocar que aparecen en una conversación la primera vez que chateas con un usuario. Por ejemplo, “Planificar un viaje” o “Crear un plan de ejercicio”.

Las frases para romper el hielo son ideales para las interacciones de servicio, como el servicio de atención al cliente o el servicio de cuentas. Por ejemplo, puedes insertar un botón de WhatsApp en tu aplicación o sitio web. Cuando los usuarios tocan el botón, el sistema los redirigirá a WhatsApp, donde podrán elegir entre un conjunto de temas personalizables que les mostrarán cómo interactuar con tus servicios.

Puedes configurar hasta cuatro frases para romper el hilo en un número de teléfono de empresa. Cada frase para romper el hielo puede tener un máximo de 80 caracteres. No se admiten los emoticonos.

Cuando un usuario toca una frase para romper el hielo, se activa un webhook de mensaje recibido estándar con la cadena de la frase asignada a la propiedad body en la carga útil. Si el usuario intenta enviarte un mensaje en lugar de tocar una frase para romper el hielo, el teclado aparecerá como una superposición, pero puede ignorarse para ver de nuevo el menú de frases para romper el hielo.

Carga útil de los webhooks

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_NAME>"
                },
                "wa_id": "<WHATSAPP_USER_ID>"
              }
            ],
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER_ID>",
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<TIMESTAMP>",
                "text": {
                  "body": "Plan a trip"
                },
                "type": "text"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Comandos

Los comandos son cadenas de texto que los usuarios de WhatsApp pueden ver al escribir una barra en la conversación con la empresa.

Los comandos se componen del comando en sí y una pista que da al usuario una idea de lo que puede suceder al usar el comando. Por ejemplo, se puede definir el comando siguiente:

/imagine - Create images using a text prompt

Cuando un usuario de WhatsApp escribe /imagina coches haciendo carreras en Marte, se activa un webhook de mensaje recibido con esa misma cadena de texto asignada a la propiedad body. Entonces, se generaría y devolvería una imagen de coches haciendo carreras en el planeta Marte.

Puedes definir hasta 30 comandos. Cada comando tiene un máximo de 32 caracteres y cada pista tiene un máximo de 256 caracteres. No se admiten los emoticonos.

Carga útil de los webhooks

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_NAME>"
                },
                "wa_id": "<WHATSAPP_USER_ID>"
              }
            ],
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER_ID>",
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<TIMESTAMP>",
                "text": {
                  "body": "/imagine cars racing on Mars"
                },
                "type": "text"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Configurar mediante la API

Con la API, también puedes configurar componentes de conversaciones y ver cualquier valor configurado.

La API de componentes de conversaciones tiene dos extremos:

POST </PHONE_NUMBER_ID>/conversational_automation, que se usa para configurar componentes de conversaciones en un número de teléfono determinado.

GET /<PHONE_NUMBER_ID>/conversational_automation, que devuelve los valores actuales de los campos “enable_welcome_message”, “commands” y “prompts” de un número de teléfono determinado.

Configurar componentes de conversaciones mediante la API

Puedes configurar componentes de conversaciones en un número de teléfono determinado con una llamada al extremo POST.

Sintaxis de la solicitud

// Enable or disable the Welcome Message for the given phone number ID
POST /<PHONE_NUMBER_ID>/conversational_automation?enable_welcome_message=<ENABLE_DISABLE>

// Configure Commands with names and descriptions
POST /<PHONE_NUMBER_ID>/conversational_automation?commands=<COMMAND_LIST>

// Configure Prompts
POST /<PHONE_NUMBER_ID>/conversational_automation?prompts=<PROMPT>

Propiedades del cuerpo

"commands": {
     "command_name": "generate"
     "command_description": "Create a new image",
     “command_name”: “rethink”
     “command_description”: “Generate new images from existing images”,
} 

Ejemplo de solicitud

   curl -X POST \
 'https://graph.facebook.com/v19.0/PHONE_NUMBER_ID/conversational_automation' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Content-Type: application/json' \
 -d '{
   "enable_welcome_message": true/false,
   "commands": [
     {
       "command_name": "tickets",
       "command_description": "Book flight tickets",
     },
     {
       "command_name": "hotel",
       "command_description": "Book hotel",
     }
   ],
 "prompts": ["Book a flight","plan a vacation"]
}'

Ejemplo de respuesta

{
  "success": true
}

Ver la configuración actual mediante la API

Puedes ver la configuración actual de los componentes de conversaciones en un número de teléfono determinado con una llamada al extremo GET.

Sintaxis de la solicitud

GET  /<PHONE_NUMBER_ID>?fields=conversational_automation

Ejemplo de respuesta

{
  "conversational_automation": {
    "enable_welcome_message": true
    "prompts": [
      "Find the best hotels in the area",
      "Find deals on rental cars"
    ],
    "commands": [
      {
        "command_name": "tickets",
        "command_description": "Book flight tickets",
      },
      {
        "command_name": "hotel",
        "command_description": "Book hotel",
      }
    ],
  }
  "id": "123456"
}

Pruebas

Para probar los componentes de conversaciones una vez que los hayas configurado, abre el cliente de WhatsApp y abre un chat con tu número de teléfono de empresa.

En el caso de los mensajes de bienvenida y las frases para romper el hielo, si ya existe una conversación abierta con el número de teléfono de empresa, debes eliminar primero dicha conversación:

1. Abre la conversación en el cliente de WhatsApp.
2. Toca el perfil del número de teléfono de empresa.
3. Toca Vaciar chat > Vaciar todos los mensajes.
4. Elimina el chat.
5. Empieza una nueva conversación con esta empresa.

A continuación, puedes enviar un mensaje al número de teléfono de empresa, que debería activar el webhook request_welcome.