Volver al blog
API-integración

Guía de Integración API - Click to Call & CRM

Integración de nuestro servicio de **Click to Call** con cualquier sistema CRM o desarrollo propio.

30 de octubre de 2026

1. Visión General de la Integración

La integración mediante API permite que tus agentes o usuarios originen llamadas telefónicas directamente desde la interfaz de tu CRM (HubSpot, Salesforce, Zoho, CRM propio, etc.), mejorando la productividad y centralizando la gestión de contactos.

📚 Colección de Postman

Puedes consultar y probar la colección completa de métodos de la API en el siguiente enlace: 👉 Ver Colección de Postman

2. Solicitud de Credenciales

Para comenzar a interactuar con la API, es necesario contar con credenciales de acceso únicas para tu cuenta (autenticación HTTP / API Keys).

  • ¿Cómo obtenerlas? Debes solicitar tus credenciales (Username API y Password API) a través de tu asesor comercial o al equipo de soporte técnico.
  • Credenciales de prueba:
  • Username: userApiDelCliente (Ejemplo demo)
  • Password: passApiDelCliente (Ejemplo demo)*

⚠️ Nota Importante: Guarda tus credenciales en un lugar seguro y no las expongas en el código del lado del cliente (frontend).

3. URLs del Entorno

  • URL de Pruebas (Desarrollo): https://voip81mariodev.comuniquemonos.com/voip/simpleipbxApiRest
  • URL de Producción: (Se proporcionará una vez completada y validada la etapa de pruebas)

4. Principales Métodos Disponibles

A continuación se describen los endpoints principales que puedes implementar en tu CRM:

A. Originar Llamada (/calls/originate)

Permite disparar una llamada desde el CRM conectando al agente con el cliente de destino.

  • Método HTTP: POST
  • Endpoint: /calls/originate
  • Headers: Content-Type: application/json

Ejemplo del Body JSON:

{
  "customer_id": "19999995",
  "account_id": "9364700201",
  "tel": "5731357477777"
}

Descripción de Parámetros:

ParámetroTipoRequeridoDescripción
customer_idStringSíID asignado a tu empresa/cliente en el sistema.
account_idStringSíID de la cuenta/extensión específica asignada al usuario o agente.
telStringSíNúmero de destino incluyendo prefijo de país (Ej: 57 para Colombia + número).

B. Métodos Adicionales (Consultar Colección Postman)

En la documentación de Postman encontrarás soporte para flujos completos de VoIP:

  1. Estado de la Llamada: Consultar si una llamada está en curso, finalizada o fallida.
  2. Historial / Registros: Obtener detalles de llamadas realizadas para sincronizar logs dentro del CRM.
  3. Gestión de Extensiones: Verificar disponibilidad de cuentas/agentes antes de enviar la solicitud.

5. ¿Cómo conectar esta API con tu CRM?

Para integrar el Click to Call en la ficha de un contacto de tu CRM, sigue estas recomendaciones estándar de arquitectura:

  1. Botón de Acción en el CRM: Crea un botón personalizado o un webhook junto al campo del teléfono del contacto (Ej: "Llamar con Click to Call").
  2. Middleware / Servidor Intermedio: Haz que el botón del CRM envíe una petición a tu propio servidor backend.
  3. Consumo de la API: Tu backend debe tomar el número del contacto, adjuntar las credenciales de la API y realizar el POST al endpoint /calls/originate.
  4. Respuesta al Usuario: Muestra al agente una notificación en el CRM confirmando que la llamada se está procesando.

📞 Soporte Técnico

Si necesitas acompañamiento durante el proceso de integración o requieren apoyo para realizar pruebas en el entorno de desarrollo, contacta a nuestro equipo de ingeniería.