Integraciones y API
GoWeBa se integra con servicios de terceros para ampliar sus funcionalidades. Este módulo explica cómo conectar, configurar y gestionar las integraciones disponibles.
Página de Integraciones
La página Configuración → Integraciones permite conectar GoWeBa a servicios de terceros.
Integraciones disponibles
| Servicio | Tipo | Función |
|---|---|---|
| Google Workspace | OAuth | Sincronización de contactos, calendario, emails, Drive |
| Microsoft 365 | OAuth | Sincronización de contactos, calendario, emails, OneDrive |
| Stripe | API Key | Pagos en línea, facturación automática |
| Twilio | API Key | Telefonía VoIP, SMS, Voice AI |
| SendGrid | API Key | Recepción y enrutamiento de emails |
| Slack | Webhook | Notificaciones de eventos GoWeBa hacia Slack |
| Zapier | Webhook | Automatizaciones con más de 5000 aplicaciones |
Configurar una integración
- Ir a Configuración → Integraciones — Se muestra la lista de integraciones disponibles
- Hacer clic en «Conectar» — Se abre el formulario de configuración
- Ingresar las credenciales — API Key, OAuth o Webhook URL según el servicio
- Probar la conexión — GoWeBa verifica que las credenciales sean válidas
- Activar — La integración está activa y comienza a sincronizar
Migración de datos
GoWeBa ofrece un asistente de migración completo para importar sus datos desde otras plataformas.
Fuentes soportadas
| Fuente | Datos migrados |
|---|---|
| Google Workspace | Contactos, emails, calendario, Drive |
| Microsoft 365 | Contactos, emails, calendario, OneDrive |
| CSV / vCard | Contactos |
| Otro CRM | Mediante exportación CSV |
Proceso de migración
- Conexión — Autenticación OAuth con el servicio de origen
- Escaneo — GoWeBa analiza los datos disponibles y muestra un resumen
- Mapeo — Verificación del mapeo de campos (GoWeBa propone un mapeo automático)
- Ejecución — Importación de datos con gestión de duplicados
- Validación — Informe detallado: importados, ignorados, errores
Webhooks salientes
GoWeBa puede enviar notificaciones HTTP (webhooks) hacia servicios externos cuando ocurren ciertos eventos:
- Nuevo contacto creado
- Tarea terminada
- Factura pagada
- Llamada recibida
- Mensaje WEBA con sentimiento negativo
Los webhooks incluyen un encabezado de firma HMAC para verificar la autenticidad.
API GoWeBa
GoWeBa expone una API REST completa para permitir integraciones personalizadas.
Puntos de acceso principales
| Endpoint | Método | Descripción |
|---|---|---|
/api/contacts | GET, POST | Lista y creación de contactos |
/api/contacts/[id] | GET, PATCH, DELETE | Detalle, modificación, eliminación |
/api/inbox/threads | GET | Lista de conversaciones de email |
/api/tasks | GET, POST | Lista y creación de tareas |
/api/calendar/events | GET, POST | Lista y creación de eventos |
/api/invoices | GET, POST | Lista y creación de facturas |
/api/weba/chat | POST | Enviar un mensaje a WEBA |
Autenticación API
Todas las solicitudes API requieren un token de autenticación válido:
Authorization: Bearer <session_token>
Los tokens se generan durante la conexión mediante NextAuth y son válidos durante la duración de la sesión.
Dominio personalizado
GoWeBa permite configurar un dominio personalizado para acceder a su plataforma:
- Configuración → Dominio — Acceder a la configuración DNS
- Agregar un dominio — Ingresar su nombre de dominio (ej: crm.miempresa.com)
- Configurar los DNS — Agregar los registros CNAME indicados en su registrador
- Verificación — GoWeBa verifica automáticamente la propagación DNS
- Activación — El dominio está activo con certificado SSL automático
FAQ
P: ¿Cuántas integraciones puedo configurar? R: No hay límite. Configure tantas integraciones como necesite.
P: ¿Las integraciones son seguras? R: Sí. Los tokens OAuth están cifrados y las API Keys se almacenan de manera segura. Ningún dato sensible se expone del lado del cliente.
P: ¿La migración sobrescribe mis datos existentes? R: No. La migración agrega datos sin eliminar los existentes. Los duplicados se detectan y gestionan de manera inteligente.
P: ¿Puedo usar la API fuera de GoWeBa? R: La API está diseñada para uso interno de la plataforma. Para integraciones avanzadas, contacte al soporte de GoWeBa.