En Zenvia Customer Cloud, la funcionalidad de Llamada de API permite que el usuario incluya una API dentro de su chatbot. La Interfaz de Programación de Aplicaciones (API) es una forma en que un programa interactúa con otro, por lo que las llamadas a la API son el medio a través del cual interactúan. Con esto, es posible utilizar una llamada a la API para enviar datos a su CRM, consultar datos de clientes en bases de datos o incluso enviar comunicaciones externas.

Cómo acceder

El contenido de Llamada de API está disponible en el Constructor del bot y para acceder, simplemente haga clic en los tres puntitos del bloque o en cualquier parte de él.

Con esto, se abrirá el modal Detalles del bloque; a continuación, siga las instrucciones:

1. Haga clic en Agregar contenido.
2. Elija Llamada de API.
3. En Método, indique el tipo de su API, ya sea: POST, GET, DELETE, PUT o PATCH.
4. Indique la URL, incluyendo un enlace para esa API.
5. En Encabezado, realice la inclusión del código correspondiente; la edición del código será igual que en cualquier editor común. Por ejemplo, puede ser Authorization, Application, etc.
6. En Cuerpo, realice la inclusión del código. Recuerde que aquí dependerá de la API. Por ejemplo, si tenemos una aplicación Json, en el cuerpo, el código será Json.

💡 Tip: Si la respuesta de la API incluye un array de objetos, como en el ejemplo a continuación, donde deseas acceder al canal de comunicación del primer evento, el código para mostrar esta información sería:

"resposta_api": {
        "body": {
          "events": [
             {
                "extra1": null,
                "extra2": null,
                "channel": "widget",
                "eventName": "new_dialog",
                "assistantId": 142,
                "environment": "dev"
          }
       ]
   },
   "code": 200,
 }