La automatización de la atención al cliente es una herramienta valiosa que puede mejorar la eficiencia y la satisfacción del usuario. Con la API de Waclis, puedes iniciar un flujo de Typebot de manera pasiva, lo que significa que el bot puede comenzar a interactuar con el usuario sin necesidad de una acción previa por parte de este. Este tutorial te guiará a través del proceso de configuración y uso de esta funcionalidad, permitiéndote iniciar conversaciones automatizadas con tus usuarios.

Esta capacidad es especialmente útil para proporcionar asistencia proactiva, enviar recordatorios o iniciar encuestas. A continuación, te explicaremos cómo preparar tu entorno de desarrollo y cómo utilizar el código PHP para iniciar un Typebot de forma pasiva.

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 iniciar el Typebot de forma pasiva.

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

  // 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": "5491144332211", // Número de WhatsApp válido para iniciar el Typebot.

    "queueId": "50" // ID del departamento asociado al Typebot.

  }',

  // 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": "REMOTE TYPEBOT START",

    "sessionId": "clshud41q00nwfyq004h7b79t",

    "messageId": {

        "key": {

            "remoteJid": "5491144332211@s.whatsapp.net",

            "fromMe": true,

            "id": "BAE569A39996AAAE"

        },

        "message": {

            "extendedTextMessage": {

                "text": "👋🏻 *Hola, soy el agente de atención al cliente de Waclis* ¿Cómo puedo ayudarte hoy?nn1️⃣ 2da copia de la factura   nn2️⃣ Desbloqueo de confianza 🆘nn3️⃣ Nueva instalación 🤩nn4️⃣ Habla con Humanonn5️⃣ Enviar imagenn6️⃣ Enviar audion7️ ⃣ Enviar videonn8️⃣ Enviar PDFnn9️ ⃣ Botones en Listann1️⃣0️⃣ Agregar etiqueta al contacto"

            }

        },

        "messageTimestamp": "1707676278",

        "status": "PENDING"

    }

}

El código PHP proporcionado realiza una petición POST a la API de waclis.com para iniciar un flujo de Typebot de forma pasiva. 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 WhatsApp y el ID del departamento asociado al Typebot.

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 que el Typebot ha comenzado de forma remota y proporcionar detalles como la sesión y el estado del mensaje.

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.