La interacción con los usuarios a través de mensajes que ofrecen opciones es una forma dinámica de mejorar la experiencia del usuario y recopilar respuestas estructuradas. La API de waclis.com proporciona una funcionalidad que permite enviar listas de opciones a través de mensajes, lo cual es ideal para encuestas, elecciones rápidas o incluso para la navegación en menús interactivos. Este tutorial te mostrará cómo implementar esta característica utilizando PHP para que puedas integrarla en tu aplicación o servicio.

Con esta herramienta, podrás ofrecer a tus usuarios una manera intuitiva y sencilla de interactuar con tu sistema, mejorando así la calidad de tu servicio y la satisfacción del usuario. A continuación, te explicaremos cómo configurar tu entorno de desarrollo y cómo enviar listas de opciones a tus usuarios.

PHP

<?php

// Inicializamos cURL para hacer una petición a la API de waclis.com.

$curl = curl_init();

// Configuramos las opciones de cURL para nuestra petición.

curl_setopt_array($curl, array(

  // Especificamos la URL de la API para enviar listas de opciones.

  CURLOPT_URL => 'https://{BACKEND_URL}/api/messages/sendList',

  // Indicamos que queremos que la respuesta sea devuelta como una cadena de texto.

  CURLOPT_RETURNTRANSFER => true,

  // Dejamos vacío el campo de codificación; cURL elegirá la codificación adecuada.

  CURLOPT_ENCODING => '',

  // Establecemos el número máximo de redirecciones que cURL seguirá.

  CURLOPT_MAXREDIRS => 10,

  // Definimos un tiempo máximo de espera para la conexión; 0 significa sin límite de tiempo.

  CURLOPT_TIMEOUT => 0,

  // Permitimos que cURL siga cualquier cabecera "Location:" que la API envíe como parte de la respuesta HTTP.

  CURLOPT_FOLLOWLOCATION => true,

  // Usamos HTTP 1.1 para la petición.

  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,

  // Establecemos que la petición será de tipo POST.

  CURLOPT_CUSTOMREQUEST => 'POST',

  // Adjuntamos los datos que vamos a enviar con la petición POST en formato JSON.

  CURLOPT_POSTFIELDS =>'{

    "number": "5411989091838", // Número de teléfono al que se enviará la lista de opciones.

    "body": "Selecciona la mejor opción", // Mensaje que introduce la lista de opciones.

    "optionList": { // Objeto que contiene la lista de opciones y la etiqueta del botón.

      "buttonLabel": "Abrir lista de opciones", // Etiqueta del botón que abrirá la lista de opciones.

      "options": [ // Array de objetos que representan las opciones disponibles.

        {

          "id": "1", // ID de la opción.

          "description": "Waclis", // Descripción de la opción.

          "title": "Waclis" // Título de la opción.

        },

        {

          "id": "2", // ID de la segunda opción.

          "description": "No funcionan", // Descripción de la segunda opción.

          "title": "Otras plataformas" // Título de la segunda opción.

        }

      ]

    }

  }',

  // Añadimos las cabeceras necesarias, incluyendo el tipo de contenido y el token de autorización.

  CURLOPT_HTTPHEADER => array(

    'Content-Type: application/json',

    'Authorization: token' // Token de autorización registrado previamente en la conexión.

  ),

));

// Ejecutamos la petición y guardamos la respuesta.

$response = curl_exec($curl);

// Cerramos la sesión cURL.

curl_close($curl);

// Imprimimos la respuesta.

echo $response;

?>

JSON

{

    "mensagem": "Mensaje enviado",

    "ticket": ticketData

}

El código PHP anterior realiza una petición POST a la API de Waclis para enviar una lista de opciones a un número de teléfono específico. Se configura cURL con varias opciones, incluyendo la URL de la API, el método de la petición (POST), y los datos que se enviarán, que en este caso es un JSON con información como el número de teléfono, el cuerpo del mensaje y la lista de opciones con sus respectivos títulos y descripciones.

Después de configurar todas las opciones, se ejecuta la petición y se cierra la sesión cURL. Finalmente, se imprime la respuesta que devuelve la API, que debería indicar si la lista de opciones fue enviada correctamente y proporcionar datos del ticket si se abrió uno.

Es importante reemplazar {BACKEND_URL} con la URL real de la API y token con el token de autorización válido para que el código funcione correctamente.

Este tutorial te proporcionará las herramientas necesarias para implementar listas de opciones interactivas en tu plataforma, mejorando así la interacción con tu audiencia.