Skip to main content
En este artículo descubrirás dónde encontrar tus Claves de API en el CloudTalk Dashboard y cómo generar una nueva clave y su secreto. Las Claves de API son necesarias para conectar CloudTalk con herramientas de terceros como Zapier, Make e integraciones personalizadas.
Nivel de usuario: Admin

¿Qué son las Claves de API?

Las Claves de API de CloudTalk son un par de credenciales, un Access Key ID y un Access Key Secret, que se utilizan para autenticar las solicitudes a la API de CloudTalk. Son necesarias siempre que conectes CloudTalk con una plataforma externa o una herramienta de automatización.
⚠️ El acceso a la API está disponible en el plan Essential y superiores. Si no ves la pestaña Claves de API, comprueba que tu cuenta se haya actualizado al plan correcto.

Dónde encontrar tus Claves de API

Las Claves de API se encuentran en la sección Configuración de tu CloudTalk Dashboard.
  1. Inicia sesión en tu CloudTalk Dashboard.
  2. En el menú de navegación de la izquierda, ve a Cuenta > Configuración.
  3. Selecciona la pestaña Claves de API en la parte superior de la página.

Cómo generar una nueva Clave de API

  1. Ve a Cuenta > Configuración > Claves de API tal como se describe más arriba.
  2. Haz clic en el botón + Agregar clave de API.
  3. Se generarán un nuevo Access Key ID y un nuevo Access Key Secret.
  4. Copia y guarda los dos valores en un lugar seguro. Puedes ver tu secreto en cualquier momento haciendo clic en el botón Mostrar que aparece junto a la clave en la página Claves de API.
⚠️ Trata tu API Key Secret como si fuera una contraseña. No lo compartas ni lo guardes en un lugar poco seguro.

Usos habituales de las Claves de API

Una vez que tengas tu API Key ID y tu Secret, puedes usarlos para autenticarte con:
  • Zapier: al conectar una nueva cuenta de CloudTalk en el editor de Zaps para usar llamadas, SMS y contactos como activador o como acción
  • HubSpot Workflows: al activar llamadas salientes de VoiceAgent o al enviar SMS a través de la API de CloudTalk como acción de un flujo de trabajo
  • Pipedrive Automations: al enviar solicitudes de webhook a CloudTalk, por ejemplo para activar SMS cuando cambia la etapa de un Deal
  • Automatizaciones de flujo de trabajo de CloudTalk: al configurar acciones de solicitud a la API dentro del creador de automatizaciones integrado en el Dashboard
  • Llamadas directas a la API: usando autenticación básica con la API REST de CloudTalk para integraciones personalizadas o pruebas de desarrollo (por ejemplo, en Postman). Consulta la referencia de la API de CloudTalk para ver todos los endpoints disponibles.

Resolución de problemas

  • La pestaña Claves de API no aparece: Comprueba que tu cuenta tenga el plan Essential o superior y que hayas iniciado sesión con un rol de Admin. Si la pestaña sigue sin aparecer después de verificar tu plan, ponte en contacto con atención al cliente de CloudTalk.
  • Errores de autenticación: Asegúrate de que no haya espacios de más al pegar el Key ID o el Secret. Genera un nuevo par de claves si el problema persiste.
  • Errores 404 o «Not a valid request»: Asegúrate de usar la URL base correcta de la API: https://api.cloudtalk.io. La URL del dashboard (my.cloudtalk.io) no da servicio a la API pública y devolverá errores si la usas en solicitudes a la API. Además, todas las rutas de los endpoints deben terminar en .json.
Para consultar la documentación completa de la API, visita developers.cloudtalk.io.

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