Skip to main content
CloudTalk no tiene un conector integrado para todos los CRM. Si has creado tu propio sistema o usas una plataforma que no está en nuestra lista de integraciones nativas, igualmente puedes conectarlo a CloudTalk. En este artículo te explicamos las vías compatibles.
Nivel de usuario: Admin

​
Antes de empezar

El acceso a la API está disponible en el plan Essential y superiores. Para saber dónde encontrar tus claves y cómo generarlas, consulta Cómo acceder a tus claves de API de CloudTalk y generarlas. Si no ves la pestaña Claves de API en tu Dashboard, lo más probable es que tu cuenta esté en un plan inferior. Si tienes dudas, contacta con el equipo de atención al cliente de CloudTalk y lo comprobaremos por ti.

​
Opción 1: Integración directa con la API REST (para desarrolladores)

CloudTalk ofrece una API REST pública que te permite leer y escribir datos de forma programática, incluidos contactos, llamadas y grabaciones.
  1. Genera tus credenciales de API: ve a Cuenta > Configuración > Claves de API y haz clic en + Agregar clave de API. Copia tanto el Access Key ID como el Access Key Secret.
  2. Envía las solicitudes a la API en api.cloudtalk.io, usando autenticación básica (tu Key ID como nombre de usuario y tu Secret como contraseña). Ten en cuenta que esta dirección es distinta de developers.cloudtalk.io (la documentación) y de dashboard.cloudtalk.io (el Dashboard), así que asegúrate de que tus solicitudes van a api.cloudtalk.io.
  3. Consulta los endpoints disponibles y los formatos de las solicitudes en developers.cloudtalk.io.
  4. Crea en tu CRM la lógica necesaria para llamar a estos endpoints en los eventos que te interesen, por ejemplo crear o actualizar un contacto cuando termina una llamada.
Consejo: prueba tus llamadas en una herramienta como Postman antes de integrarlas en tu CRM. Usa la opción Authorization > Basic Auth y pega tu Key ID y tu Secret. Vigila las cabeceras de respuesta del límite de frecuencia y reduce el ritmo si los alcanzas; los límites actuales están documentados en developers.cloudtalk.io.

​
Opción 2: Recibir eventos en tiempo real con Webhooks (para desarrolladores)

Los Webhooks envían los eventos de CloudTalk a un endpoint HTTPS tuyo en el mismo momento en que ocurren, así tu CRM se mantiene sincronizado sin consultar la API continuamente. Los eventos cubren llamadas, contactos, usuarios, mensajes, inteligencia conversacional, VoiceAgents y Marcador. Cada evento llega como JSON firmado.
  1. Ve a Cuenta > Webhooks y haz clic en Añadir endpoint. Necesitas el rol de Admin.
  2. Introduce tu URL HTTPS y elige los tipos de evento que quieras. Deja la selección vacía para recibir todos los eventos, incluidos los que se añadan más adelante.
  3. Copia el secreto de firma del endpoint y verifica la firma en cada entrega.
  4. Haz clic en Send test event y comprueba que tu endpoint responde con un 2xx. Verás el resultado en el registro de entregas.
Las entregas fallidas se reintentan automáticamente, y puedes reenviarlas o recuperarlas desde la misma página durante un máximo de 30 días. Para ver los payloads, la verificación de firmas y las buenas prácticas, consulta la guía de Webhooks para desarrolladores.

​
Opción 3: Enviar eventos a tu CRM con la Automatización de flujos de trabajo

Si quieres que CloudTalk envíe datos a tu CRM automáticamente cuando ocurra algo (por ejemplo, cuando termine una llamada), puedes configurar una Automatización de flujos de trabajo que envíe una solicitud HTTP a un endpoint que controles.
  1. En tu CRM, o en un servidor que controles, configura un endpoint capaz de recibir solicitudes HTTP POST.
  2. En CloudTalk, ve a Cuenta > Automatizaciones de flujo de trabajo y crea una automatización que se active con el evento que quieras y que añada una acción que envíe una solicitud HTTP a la URL de tu endpoint. Consulta la guía de Automatizaciones de flujo de trabajo para la configuración.
  3. CloudTalk envía los datos del evento a tu endpoint cuando se dispara el activador.
  4. Analiza el payload en tu CRM para actualizar registros, registrar llamadas o lanzar acciones de seguimiento.
Bueno es saberlo: las solicitudes HTTP de la Automatización de flujos de trabajo se entregan con el mejor esfuerzo posible. Si tu endpoint no está disponible temporalmente, se puede perder una entrega y no hay forma de reproducirla por tu cuenta. Si necesitas una entrega de eventos fiable con reintentos y reproducción, usa Webhooks (Opción 2) en su lugar.

​
Opción 4: Puente sin código con Zapier o Make

Si prefieres no escribir código, Zapier y Make pueden hacer de puente entre CloudTalk y tu CRM. Ambas plataformas admiten CloudTalk como activador y como origen de acciones. Zapier: sigue la guía Configurar Zapier para conectar tu cuenta de CloudTalk y después crea un Zap que se active con un evento de CloudTalk y envíe los datos a tu CRM, ya sea mediante una acción nativa del CRM o mediante un paso de webhook. Make (antes Integromat): añade la app de CloudTalk en Make (consulta la documentación de CloudTalk de Make en apps.make.com/cloudtalk) y después crea un escenario que se active con un evento de CloudTalk, como una llamada nueva, y que asigne los campos a tu CRM. La app de CloudTalk en Make incluye una acción genérica «Make an API Call», así que si tu CRM no es una app nativa de Make, o necesitas una operación de CloudTalk sin módulo específico, igualmente puedes llegar a cualquier endpoint de CloudTalk a través de ese paso. Las dos herramientas admiten pasos personalizados de webhook/HTTP, de modo que incluso un CRM que no sea una app nativa en ninguna de las dos plataformas puede recibir datos.

​
¿Qué opción me conviene?

¿Necesitas ayuda o tienes alguna pregunta? Escríbenos a través de nuestro Portal de atención al cliente : estamos aquí para ayudarte.