Skip to main content
El paso Solicitud HTTP te permite conectar tus flujos de llamadas de CloudTalk con sistemas y API externos. En esta guía aprenderás a configurar y usar el paso Solicitud HTTP para enviar solicitudes, gestionar respuestas e integrar datos externos directamente en tus flujos de llamadas.
Nivel de usuario: Admin

​
Uso del paso Solicitud HTTP

El paso Solicitud HTTP te permite ampliar tus flujos de llamadas más allá de CloudTalk conectándolos con sistemas y API externos. Hace posible el intercambio de datos, la automatización y la toma de decisiones en tiempo real durante una llamada. Tanto si enriqueces los datos de la llamada, como si actualizas registros externos o personalizas la experiencia de los clientes, el paso Solicitud HTTP te da la flexibilidad necesaria para crear flujos de trabajo más inteligentes y mejor conectados.

​
Añadir una Solicitud HTTP a tu flujo de llamadas

  1. En el Dashboard, haz clic en Números.
  2. En la pestaña Mis números, busca el número que quieras configurar.
  3. Haz clic en + Configurar (o en el nombre del flujo, si ya existe uno) en la columna Flujo de llamadas.
  4. En el lienzo, haz clic en el botón + en el punto donde quieras el paso.
  5. En la biblioteca de pasos, dentro de Automatización, selecciona Solicitud HTTP.

​
Configurar solicitudes HTTP

6. Haz clic en el paso Solicitud HTTP del lienzo para abrir su panel de configuración. Están disponibles los siguientes elementos:

​
Endpoint

El endpoint define la URL a la que se llamará. La comunicación requiere HTTPS.

​
Método

El método de la solicitud HTTP, es decir, el tipo de acción que se pide realizar al receptor del endpoint. Opciones disponibles: GET, POST, PUT, PATCH, DELETE.

​
Encabezados de la solicitud (opcional)

Los encabezados de la solicitud aportan metainformación sobre ella, como el formato del cuerpo de la solicitud o las credenciales de autorización. Haz clic en Agregar nuevo para definir encabezados adicionales. El tipo de encabezados depende de la API externa a la que te conectes.

​
Cuerpo de la solicitud

El cuerpo de la solicitud es la carga de datos que se envía con ella. Haz clic en Agregar nuevo para definir pares clave-valor como atributos de datos. También puedes hacer clic en Agregar campo personalizado de contacto para insertar datos del contacto directamente. El cuerpo de la solicitud se envía en formato JSON (por ejemplo: {"key1":"value1", "key2":"value2"}). Además de valores constantes, puedes usar las siguientes variables dinámicas: Atributos de la llamada: Atributos del contacto: Recopilar entrada:
Consejo: Guarda el flujo antes de hacer referencia a un ID de paso. Antes de guardar, los pasos tienen IDs negativos temporales que pueden no funcionar correctamente. Después de guardar, el ID del paso pasa a ser un número positivo permanente.
Nota: Recopilar entrada puede devolver un valor vacío si el llamante no introdujo nada. Durante la creación inicial, puedes usar el ID temporal; se sustituirá una vez guardado el flujo.

​
Opciones de anidamiento

Si un endpoint externo requiere objetos anidados, usa la notación de puntos en el campo Clave: key.subkey. Por ejemplo:
  • customer.firstname = John
  • customer.lastname = Doe
Da como resultado: { "customer": { "firstname": "John", "lastname": "Doe" }}

​
Analizar respuesta

La casilla Analizar respuesta define cómo gestiona CloudTalk los datos recibidos del sistema externo.
  • Si está desactivada El flujo de llamadas continúa inmediatamente después de enviar la solicitud, sin esperar una respuesta. Resulta útil para solicitudes de tipo “enviar y olvidar”, en las que no se necesitan los datos de la respuesta.
  • Si está activada El flujo de llamadas espera a la respuesta HTTP antes de continuar. Los datos devueltos quedan entonces disponibles para usarlos en pasos posteriores.

​
Retener datos después de la llamada

Marca Retener datos después de la llamada para que los datos de la respuesta HTTP sigan disponibles una vez finalizada la llamada. Esto resulta útil si necesitas los datos para el procesamiento posterior a la llamada o para informes.

​
Usar la respuesta en pasos posteriores

Cuando Analizar respuesta está activado, el cuerpo de la respuesta se puede usar en un Divisor de condición para enrutar las llamadas según los datos devueltos. En la configuración del Divisor de condición: 1. Selecciona Respuesta HTTP en el menú desplegable Propiedad. Se mostrará la URL del endpoint del paso Solicitud HTTP (p. ej., “Respuesta HTTP - https://api.example.com/customer”) para que sepas a qué solicitud hace referencia. 2. Introduce la ruta JSON hasta la propiedad de la respuesta usando la notación de puntos. Ejemplo: Si la respuesta tiene este aspecto:
  • Para hacer referencia a la propiedad de nivel superior status, usa: status
  • Para hacer referencia a la propiedad anidada error code, usa: error.code
  • Para propiedades indexadas (listas o arrays), usa la notación de puntos con el número de índice: status.0 para el primer elemento, status.1 para el segundo, y así sucesivamente.
3. Define la condición deseada (Operando y Valor) según lo que necesites que coincida.
Con esta configuración, cada vez que una llamada llega al paso Solicitud HTTP se envía una solicitud al sistema externo. Los datos de la respuesta determinan después la siguiente ruta de la llamada, lo que permite gestionar cada llamada de forma dinámica con la información más actualizada.
¿Necesitas ayuda o tienes alguna pregunta? Escríbenos a través de nuestro Portal de atención al cliente — estamos aquí para ayudarte.