> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrar un CRM propio o personalizado con CloudTalk

> Conecta un CRM propio o personalizado a CloudTalk mediante la API REST, Webhooks, la Automatización de flujos de trabajo o un puente sin código como Zapier o…

<Note>
  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.
</Note>

**Nivel de usuario**: Admin

***

<h2 id="h_11b71a1c7b">
  Antes de empezar
</h2>

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.](/es/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys) 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.

<h2 id="h_635fbfead1">
  Opción 1: Integración directa con la API REST (para desarrolladores)
</h2>

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](/developers) (la documentación) y de [dashboard.cloudtalk.io](https://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](/developers)**.

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.

<Warning>
  **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](/developers).
</Warning>

<h2 id="h_58791abb69">
  Opción 2: Recibir eventos en tiempo real con Webhooks (para desarrolladores)
</h2>

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](/guides/webhooks/overview).

<h2 id="h_0e615ae39c">
  Opción 3: Enviar eventos a tu CRM con la Automatización de flujos de trabajo
</h2>

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](/es/articles/5450779-configuring-workflow-automations) 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.

<Tip>
  **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.
</Tip>

<h2 id="h_089c28fdc5">
  Opción 4: Puente sin código con Zapier o Make
</h2>

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](/es/articles/3410740-configure-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](https://www.make.com/en/integrations/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.

<h2 id="h_9b237ff688">
  ¿Qué opción me conviene?
</h2>

| | **API REST** | **Webhooks** | **Automatización de flujos de trabajo** | **Zapier / Make** |
| - | - | - | - | - |
| Requiere programar | Sí | Sí (endpoint y verificación de firma) | Poco (configurar el endpoint) | No |
| Dirección de los datos | Tú solicitas los datos | CloudTalk los envía al producirse un evento | CloudTalk los envía al producirse un evento | Las dos |
| Ideal para | Lecturas masivas, sincronización de contactos, control total | Flujos de eventos en tiempo real hacia tu CRM o tus herramientas internas | Enviar eventos de llamadas a tu sistema | Configuración rápida, equipos sin código |
| Garantía de entrega | Tú controlas los reintentos | Reintentos automáticos, reenvío y recuperación durante 30 días | Mejor esfuerzo, sin reproducción autogestionada | Depende de la plataforma |

***

*¿Necesitas ayuda o tienes alguna pregunta?* Escríbenos a través de nuestro [Portal de atención al cliente](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) : estamos aquí para ayudarte.


## Related topics

- [Usar CloudTalk con Capsule CRM](/es/articles/11196736-using-cloudtalk-with-capsule-crm.md)
- [Atributos personalizados](/es/articles/2144934-custom-attributes.md)
- [Extracción de temas](/es/articles/9220291-topics-extraction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.