Integraciones
Integración por API y otros protocolos
Si no hay una integración lista para su sistema, lo conectamos a CONTACT.WORK con el protocolo que admita: REST y webhooks, SOAP, acceso directo a la base de datos, SIP y AMI para la telefonía, SMPP para SMS, IMAP y SMTP para el correo electrónico, y MCP para los agentes de IA. El agente ve en pantalla la información de su sistema, y las llamadas, las conversaciones y sus resultados vuelven a él.
GET /api/clients?phone=79000000015 200 · 84 ms
{ "name": "Juan Romero", "orders": 2, "debt": 0, "manager": "Ana" } Funciones
Qué obtiene con API y protocolos
Ejemplos
Qué conectan las empresas por API
Normalmente se necesitan tres cosas: ver al cliente cuando llama, guardar el resultado de la llamada y lanzar llamadas o mensajes a partir de eventos de su sistema.
El cliente en pantalla, identificado por su número
Con cada llamada entrante, CONTACT.WORK consulta a su sistema los datos de quien llama: nombre, pedidos, saldo pendiente, estado de la solicitud. Si su sistema tiene REST o SOAP, tomamos los datos por ahí; si no, los leemos de la base de datos o de una exportación reciente.
- Búsqueda del cliente por número
- Pedidos y estados en el formulario del agente
- REST, SOAP, SQL o una exportación
GET /api/clients?phone=79000000015 200 · 84 ms
{ "name": "Juan Romero", "orders": 2, "debt": 0, "manager": "Ana" } El resultado de la llamada llega a su sistema
Tras colgar, su sistema recibe lo que haga falta: el registro de la llamada, el audio, lo anotado por el agente, una solicitud nueva o una tarea. Al instante por webhook o por lotes cada pocos minutos, según lo que convenga a su sistema.
- Webhook nada más terminar la llamada
- Enlace a la grabación y resultado del formulario
- Una solicitud o tarea para la persona adecuada
POST /hooks/calls
{ "event": "call.finished", "duration": 192,
"result": "Pedido confirmado", "record": "…/rec/8841" } - Respuesta del sistema: 200 OK
- Tarea creada en el CRM: «Enviar el pedido #1024»
Llamadas y mensajes lanzados por eventos
Su sistema activa acciones de la plataforma de forma automática: un pedido nuevo lanza una llamada de confirmación, un pago atrasado un recordatorio, un cambio de estado, un aviso por SMS o mensajero. La plataforma tiene una API para esto, y sus desarrolladores también pueden usarla.
- Llamada por evento
- SMS y mensajería por API
- Llamadas a la API desde su sistema
order.createdLlamada de confirmacióniniciadopayment.overdueRecordatorio del agente de IA3 intentosstatus.changedSMS al clienteentregadoticket.closedEncuesta en WhatsAppenviadoPara los CRM y mensajeros con integración ya preparada hay páginas aparte. Esta explica cómo conectar un sistema que no aparece allí.
Cómo funciona
Protocolos que usamos
Servicios web
REST, SOAP y webhooks
La mayoría de los sistemas actuales ofrecen sus datos por REST o SOAP y pueden avisar de eventos con webhooks. Es la vía más sencilla: los datos llegan al instante y una clave de acceso limita los permisos.
- REST y JSON
- SOAP y XML
- Webhooks en ambos sentidos
RESTen ejecuciónSOAPen ejecuciónwebhooksen ejecuciónRESTpruebaTelefonía y mensajería
SIP, AMI, ARI, SMPP, IMAP
Conectamos su central telefónica por SIP, leemos los eventos de Asterisk por AMI y ARI, y los de FreeSWITCH por ESL. Los proveedores de SMS se conectan por su API o por SMPP, y el correo electrónico por IMAP y SMTP.
- Su central y sus operadores por SIP
- AMI y ARI para Asterisk
- SMPP, IMAP y SMTP
SIPTroncal del operador – registradaAMINueva llamada 34910100115 → cola 501ARILa agente Ana se unió a la llamadaSMPPSMS «Su pedido está listo» – entregadoIMAPNuevo correo a mostrar el correoAcceso directo a los datos
Bases de datos, archivos y agentes de IA
Si el sistema no tiene API, leemos y escribimos en su base de datos (PostgreSQL, MySQL o MS SQL) o intercambiamos archivos de forma programada. Los conectores MCP dan a los agentes de IA acceso a datos y acciones.
- Bases de datos SQL y ODBC
- CSV y Excel de forma programada
- MCP para agentes de IA
PostgreSQLPedidos y estadosen líneaMS SQL · ODBCNiveles de existenciasen líneaCSV por SFTPLista de precioscada 15 minMCPBúsqueda de cliente para el agente de IAen líneaSistemas de negocio
Facturación, gestión documental e intranets
Su centro de contacto también puede conectarse a sistemas que no son un CRM. Los agentes ven el saldo y la tarifa de un abonado tomados del sistema de facturación, una llamada crea una solicitud en su sistema de gestión documental y, en la intranet de la empresa, los empleados llaman con un clic y ven qué compañeros están disponibles.
- Saldo del abonado desde facturación
- Solicitudes en la gestión documental
- Llamar a un compañero desde la intranet
Facturaciónsaldo de la cuentaen pantallaGestión documentalsolicitud desde una llamadacreadoPortalclic para llamaren ejecuciónDirectorioestado del empleadodisponibleSistemas de centro de contacto
Junto a su software de centro de contacto actual
Si ya usa software de centro de contacto de otros proveedores, no hace falta reemplazarlo el primer día: CONTACT.WORK trabaja a su lado. Se puede compartir la telefonía, sincronizar los eventos de llamada en ambos sentidos y enviar las grabaciones a su sistema de control de calidad. La migración se hace línea por línea.
- Telefonía compartida
- Sincronización de eventos en ambos sentidos
- Migración línea a línea
TelefoníacompartidotroncalEventos de llamadabidireccionalpor APIGrabacionesal sistema de control de calidadsincronizadoMigraciónlínea por líneasegún lo previstoConfiguración
Cómo conectamos su sistema
- 01AnálisisVemos qué datos necesitan los agentes y adónde deben ir los resultados de las llamadas.
- 02Método de intercambioElegimos la vía: la API del sistema, webhooks, la base de datos o archivos programados.
- 03AccesosSu administrador emite una clave o una cuenta solo con los permisos necesarios.
- 04DesarrolloCreamos el conector y acordamos qué campos y eventos se transmiten.
- 05PruebasHacemos llamadas de prueba y comprobamos los datos en ambos sistemas.
- 06Puesta en marchaActivamos el intercambio en todas las líneas y vigilamos el registro de errores durante la primera semana.
Requisitos
Qué requiere una integración por API
- Sistema
- Al menos una forma de extraer datos: una API, la base de datos o una exportación
- Accesos
- Una clave o una cuenta con acceso solo a los datos necesarios
- Red
- La plataforma y su sistema pueden comunicarse, por internet o en una misma red
- Documentación
- Documentación de la API o esquema de la base de datos, si existen
- Persona de contacto
- El administrador del sistema durante la configuración y las pruebas
- Costo
- Desarrollo: horas pagadas con Pro o descontadas del cupo de Maxi
Preparación
Qué preparar para una integración por API
Preguntas y respuestas
Preguntas frecuentes
¿Qué sistemas pueden conectar por API?
Cualquier sistema que permita intercambiar datos: REST o SOAP, webhooks, una base de datos o una exportación de archivos. Lo más habitual son CRM, ERP, software de contabilidad, sitios web y sistemas internos.
¿Y si nuestro sistema no tiene API?
Entonces trabajamos directamente con su base de datos o intercambiamos archivos de forma programada. Es más lento que una API, pero basta para muchas tareas.
¿Pueden nuestros desarrolladores trabajar ellos mismos con la API de la plataforma?
Pueden: con la API, su software lanza llamadas y mensajes y recibe los eventos de las conversaciones. Les ayudamos al principio y les indicamos qué métodos se ajustan a su tarea.
¿Qué acceso tendrá la plataforma a nuestro sistema?
Solo el que usted conceda a la clave o a la cuenta; por ejemplo, leer clientes y pedidos y crear tareas. Con CONTACT.WORK instalado en su infraestructura, el intercambio de datos no sale de su red.
¿En qué se diferencia una API de un conector MCP?
Una API es un intercambio entre sistemas: los datos llegan al formulario del agente y vuelven. Un conector MCP da a un agente de IA acceso a datos y acciones, para que encuentre lo que necesita y realice las operaciones permitidas sin intervención de una persona.
¿Qué pasa si nuestro sistema se cae?
Las llamadas y los chats siguen funcionando: el agente simplemente no verá los datos de su sistema hasta que vuelva. La plataforma envía los resultados de las llamadas más tarde, cuando su sistema responde de nuevo.
¿Y si cambia la API de nuestro sistema?
Actualizamos el conector para la nueva versión. Si nos avisa del cambio con antelación, lo hacemos antes de la migración para que el intercambio no se interrumpa.
¿Podemos hacer llamadas directamente desde nuestra propia aplicación?
Puede iniciar y gestionar llamadas y campañas salientes desde sus aplicaciones corporativas, sin que los empleados tengan que cambiar de sistema. Las grandes empresas con soluciones propias suelen trabajar así.
¿Cuánto cuesta una integración por API?
Se paga únicamente el desarrollo: con Pro, 60 USD la hora; con Maxi, sale de las horas incluidas. Estimamos el alcance tras una revisión breve.
Glosario
Términos de esta página
- API (interfaz de programación de aplicaciones)
- La forma en que los programas intercambian datos sin que intervenga una persona. Más información →
- Webhook
- Un mensaje que un sistema envía a otro automáticamente cuando ocurre algo. Más información →
- REST: intercambio de datos entre sistemas por HTTP
- La forma estándar en que los programas intercambian datos por internet. Más información →
- SMTP e IMAP – protocolos de correo electrónico
- Protocolos de correo: SMTP envía los mensajes, IMAP los lee en el servidor. Más información →
- MCP (Model Context Protocol)
- Un protocolo abierto que permite a la IA trabajar con los datos y acciones de otros sistemas. Más información →
- CRM: gestión de relaciones con clientes
- Donde la empresa guarda sus clientes, negociaciones y todo el historial de comunicación. Más información →
- SQL (Structured Query Language)
- El lenguaje con el que el software trabaja con los datos de las bases de datos. Más información →
- Conector
- Un módulo listo que une la plataforma con la telefonía, un CRM u otro sistema. Más información →
- SIP (Session Initiation Protocol)
- El protocolo que establece las llamadas en la telefonía IP. Más información →
- AMI: Asterisk Manager Interface
- El canal por el que Asterisk informa de las llamadas y recibe comandos. Más información →
- SMPP (Short Message Peer-to-Peer)
- El protocolo con el que un sistema envía SMS a través de un operador. Más información →
- ERP – planificación de recursos empresariales
- Pedidos, inventario y finanzas en un solo sistema. Más información →
- ARI: sus propias aplicaciones de llamada en Asterisk
- La interfaz con la que su propia aplicación controla una llamada de Asterisk. Más información →
- Central telefónica IP (IP PBX)
- El sistema telefónico de la empresa que funciona por internet y por la red local. Más información →
- Gestión de la calidad en el centro de contacto
- Las llamadas y los chats se evalúan con una ficha para detectar errores y formar a los agentes. Más información →
- Despliegue en la nube
- La plataforma funciona en los servidores del proveedor y los agentes se conectan por internet. Más información →
Actualizado: