Crear una integración
Una integración conecta una API con Connect. Créala con un nombre, la URL base de tu API y la forma en que iniciarán sesión tus usuarios.
En esta página
Crea una integración por API. Todo lo demás cuelga de ella: el dominio verificado, la autenticación de usuarios, las tools, los canales y la dirección MCP a la que se conectan tus usuarios.
Crear una integración
En API y tools, elige Nueva integración.
| Campo | Reglas |
|---|---|
| Nombre | De 1 a 80 caracteres. Lo ven tus usuarios al conectarse y lo reciben los asistentes. Usa el nombre público de tu producto. |
| URL base de la API | HTTPS en un dominio público, hasta 2.048 caracteres. Las rutas de las tools van a partir de ella, por ejemplo https://api.acme.com/v1 más /orders. |
| Autenticación | API key u OAuth. Puedes cambiarla después. |
La URL base tiene que cumplir estas reglas:
- Empieza por
https://. - Sin usuario ni contraseña, sin query string (
?) y sin fragmento (#). - Puerto 443 (el de siempre) u 8443.
- Un nombre de dominio, no una dirección IP, y no
localhost.
Nota
Por ahora el nombre y la URL base no se pueden cambiar después de crear la integración. Si necesitas otros, crea una integración nueva.
Quién puede crear integraciones
Los propietarios y administradores de la cuenta. Los miembros pueden ver las integraciones pero no cambiarlas. Una cuenta puede tener hasta 10 integraciones.
El slug y la dirección MCP
Cada integración tiene un slug que aparece en sus direcciones, como https://connect.grostify.com/t/acme/mcp. No sale del nombre: Connect lo asigna cuando verificas tu dominio, a partir del dominio de tu API.
| Host de la API | Slug |
|---|---|
api.acme.com | acme |
api.empresa.com.mx | empresa |
myapp.run.app | myapp |
- Si el slug está ocupado, Connect añade
-2,-3, etc. - Los nombres de marcas conocidas y algunas palabras reservadas (por ejemplo
api,admin,claudeowhatsapp) llevan un sufijo aleatorio de 5 caracteres. - El slug no se puede editar.
Los pasos de configuración
La página de la integración te guía por siete pasos. Se abre en el primero que queda pendiente.
| Paso | Hecho cuando |
|---|---|
| 1. Dominio | El dominio está verificado. |
| 2. Autenticación | Hay una credencial de prueba guardada. |
| 3. Importar API | Hay al menos una importación o una tool. |
| 4. Tools | Al menos una tool está habilitada en un canal. |
| 5. Producción | La integración está publicada. |
| 6. WhatsApp | El asistente de WhatsApp está activado. Opcional. |
| 7. Chat web | El chat web está activado. Opcional. |
En Gestionar también tienes Conexiones y Ajustes, donde se elimina la integración.
Eliminar una integración
Eliminar una integración borra sus tools, sus conexiones, los vínculos de WhatsApp y las respuestas del asistente, las sesiones y conversaciones del chat web, y sus registros de llamadas. Las conversaciones normales de WhatsApp se quedan en la bandeja.
Atención
Las keys y tokens de tu propio sistema siguen siendo válidos allí hasta que cada usuario los revoque. Y el slug queda retirado: solo tu cuenta, con el mismo host de API, puede volver a usarlo.
Eliminar requiere haber iniciado sesión hace poco (en los últimos 10 minutos).