Componentes conversacionales

Los componentes conversacionales son funciones integradas en el chat que puedes activar en números de teléfono comerciales. Permiten que los usuarios de WhatsApp interactúen con tu negocio fácilmente. Puedes configurar comandos fáciles de usar, proporcionar disparadores de conversación predeterminados que los usuarios pueden tocar para iniciar una conversación y saludar a los usuarios nuevos con un mensaje de bienvenida.

Limitaciones

Si un usuario de WhatsApp toca un enlace universal (es decir, un enlace wa.me) que está configurado con un texto predeterminado, las interfaces de usuario de los disparadores de conversación se cerrarán automáticamente.

Configuración a través del administrador de WhatsApp (WAM)

Puedes configurar todas estas características en el administrador de WhatsApp en los números específicos que selecciones:

1. Ve al panel Mis Apps en el sitio web de Meta for Developers.
2. Selecciona tu app; luego, en WhatsApp, que se ubica en el panel izquierdo, selecciona Configuración.
3. En Números de teléfono, selecciona Administrar números de teléfono.
4. En la esquina superior derecha del número de teléfono que deseas configurar, selecciona el icono de engranaje en Configuración.
5. Selecciona Automatizaciones.
6. Accede a los componentes conversacionales y configúralos.

Los socios de soluciones también pueden configurar estas características para sus clientes si tienen acceso a la cuenta de WhatsApp Business de sus clientes en el administrador de WhatsApp.

Mensajes de bienvenida

Puedes recibir notificaciones por webhook cuando un usuario de WhatsApp inicia un chat contigo por primera vez. Hacerlo puede ser útil si deseas responder a estos usuarios con un mensaje de bienvenida personalizado especial.

Los mensajes de bienvenida son ideales para lograr interacciones de servicio, como servicio de atención al cliente o servicio de cuenta. Por ejemplo, puedes insertar un botón de WhatsApp en tu app o sitio web. Cuando los usuarios hacen clic en el botón, se redirigirán a WhatsApp, donde recibirán un mensaje de bienvenida que proporciona 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 tu número de teléfono comercial. Si no hay ninguno, el cliente activa un webhook messages con type configurado en request_welcome. Puedes responder al usuario con tu propio mensaje de bienvenida.

El webhook request_welcome activa un intervalo del servicio al cliente, que permite que tu negocio envíe mensajes sin formato cuando respondes a los clientes.

Mensaje de plantilla de secuencia como mensaje de bienvenida

Carga útil del webhook

{
  "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"
        }
      ]
    }
  ]
}

Disparadores de conversación

Los disparadores de conversación son cadenas de texto personalizables que se pueden tocar y aparecen en un hilo de mensajes la primera vez que chateas con un usuario. Por ejemplo, "Planea un viaje" o "Crea un plan de entrenamiento".

Los disparadores de conversación son ideales para mantener interacciones de servicio, como servicio de atención al cliente o servicio de cuenta. Por ejemplo, puedes insertar un botón de WhatsApp en tu app o sitio web. Cuando los usuarios tocan el botón, se redirigirán a WhatsApp, donde pueden seleccionar un conjunto de indicaciones personalizables que le mostrarán cómo interactuar con los servicios que ofreces.

Puedes configurar hasta 4 disparadores de conversación en relación con un número de teléfono comercial. Cada uno puede tener un máximo de 80 caracteres. No se admiten emojis.

Cuando un usuario toca un disparador de conversación, se activa un webhook de mensaje recibido estándar con la cadena del disparador de conversación que se asignó a la propiedad body en la carga útil. Si el usuario intenta enviarte un mensaje, en vez de tocar un disparador de conversación, verá el teclado superpuesto, pero podrá cerrarlo para ver nuevamente el menú del disparador de conversación.

Carga útil del webhook

{
  "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 con funciones específicas. Para ver los comandos disponibles, los usuarios de WhatsApp pueden escribir una barra (/) en una conversación con tu empresa.

Los comandos están compuestos por el comando mismo y una pista, que da al usuario una idea de lo que puede suceder cuando se usa el comando. Por ejemplo, podrías definir el comando:

/imagine - Create images using a text prompt

Si un usuario de WhatsApp escribe, /imagine cars racing on Mars (imagina autos corriendo en Marte), se activa un webhook de mensaje recibido con esa cadena de texto exacta asignada a la propiedad body. Entonces, podrías generar y devolver una imagen de autos corriendo en el planeta Marte.

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

Carga útil del webhook

{
  "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"
        }
      ]
    }
  ]
}

Configuración a través de la API

Con la API, también puedes configurar componentes conversacionales y ver los valores configurados.

La API de componentes conversacionales tiene dos puntos de conexión:

POST </PHONE_NUMBER_ID>/conversational_automation, que se utiliza para configurar componentes conversacionales 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 conversacionales a través de la API

Puedes configurar componentes conversacionales en un número de teléfono determinado llamando al punto de conexión 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 a través de la API

Puedes ver la configuración actual de los componentes conversacionales de un número de teléfono determinado si llamas al punto de conexión 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 conversacionales una vez que se configuraron, abre el cliente de WhatsApp y un chat con tu número de teléfono del negocio.

En cuanto a los mensajes de bienvenida y los disparadores de conversación, si ya tienes una conversación por chat en curso con el número de teléfono comercial, primero debes borrarla:

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

Puedes enviar un mensaje al número de teléfono de negocio, lo que debería activar el webhook request_welcome.