Copilot Bridge
Copilot Bridge le permite interactuar con el AI Copilot de graph8 desde sus aplicaciones de mensajería habituales: haga preguntas, consulte contactos, ejecute enriquecimientos y obtenga información sin abrir el panel de graph8. Bridge pone a su disposición el conjunto completo de herramientas de Copilot directamente dentro de su flujo de trabajo actual.
Bridge frente a integraciones del espacio de trabajo
No confunda Copilot Bridge con las integraciones de Slack/Roam a nivel de espacio de trabajo. Utilizan las mismas plataformas, pero cumplen funciones distintas:
| Funcionalidad | Ubicación | Qué hace |
|---|---|---|
| Copilot Bridge | Perfil → Apps | Redirige sus mensajes directos a Copilot para búsquedas con IA, oportunidades y enriquecimiento |
| Configuración → Integraciones → Slack | Configuración | Envía notificaciones y alertas de graph8 a canales |
| Configuración → Integraciones → Roam | Configuración | Sincroniza transcripciones y grabaciones de reuniones en el inbox |
Ambas pueden estar activas a la vez. Bridge es personal y por usuario; las integraciones de Configuración aplican a todo el espacio de trabajo.
Plataformas compatibles
| Plataforma | Cómo funciona | Identificador |
|---|---|---|
| Envíe un mensaje a su número de teléfono conectado; las respuestas se redirigen a Copilot | Número de teléfono (solo dígitos) | |
| Slack | Envíe un mensaje directo al bot de graph8 en su espacio de trabajo | ID de usuario de Slack |
| Roam | Envíe un mensaje en un grupo conectado o por mensaje directo | ID de usuario/grupo de Roam |
| iMessage | Envíe un mensaje a su número de teléfono o correo electrónico conectado | Número de teléfono o correo electrónico |
Configuración de una conexión
- Vaya a Perfil → Apps
- Abra la subpestaña Configuración
- Localice en Mensajería la plataforma que desea conectar
- Siga el proceso específico de cada plataforma que se describe a continuación
Una vez conectada, envíe un mensaje de prueba: Copilot responde en pocos segundos.
- Haga clic en la tarjeta de WhatsApp e ingrese su número de teléfono (solo dígitos, con código de país)
- Haga clic en Conectar
- Envíe un mensaje al número de WhatsApp de graph8 para verificar la conexión
WhatsApp utiliza el servidor GOWA autohospedado de graph8 para la entrega. Su número de teléfono se agrega a un índice de enrutamiento para que los mensajes provenientes de ese número siempre lleguen al bridge de su organización.
Slack
- Haga clic en Conectar Slack
- Autorice el bot de graph8 en su espacio de trabajo de Slack (flujo OAuth)
- Tras la autorización, seleccione su usuario de Slack en la lista de usuarios del espacio de trabajo
- Envíe un mensaje directo al bot de graph8 para comenzar a chatear
El flujo OAuth de Slack otorga al bot acceso únicamente a canales de mensajes directos, no a canales públicos ni a otros mensajes directos. El bot lo identifica por su ID de usuario de Slack, por lo que cambiar de espacio de trabajo requiere reconectarse.
Roam
- Haga clic en Conectar Roam
- Inicie sesión en Roam y autorice a graph8
- Seleccione un grupo de Roam o un mensaje directo personal como destino de enrutamiento
- Los mensajes del grupo o mensaje directo seleccionado se redirigen a Copilot
Si conectó Roam antes de marzo de 2026, desconéctese y vuelva a conectarse para obtener los permisos más recientes.
iMessage
- Haga clic en Conectar iMessage
- Ingrese su número de teléfono o dirección de correo electrónico
- Envíe un iMessage de prueba al contacto de iMessage de graph8
La entrega de iMessage se realiza a través de un servidor BlueBubbles autohospedado. La conexión se identifica por el número de teléfono o correo electrónico que registró.
Qué puede hacer
Bridge le ofrece las mismas capacidades que el Copilot integrado en la aplicación: las mismas herramientas, el mismo acceso y el mismo contexto.
Búsquedas e investigación
- “¿Qué sabemos sobre Acme Corp?” — obtiene enriquecimiento de la empresa, señales recientes y estado de la oportunidad
- “Muéstreme mis 5 mejores leads de esta semana” — filtra su CDP por recencia y puntuación
- “¿Alguien de Stripe ha respondido a mi outbound?” — busca en el inbox por empresa
Acciones
- “Enriquece este correo: [email protected]” — ejecuta un enriquecimiento en cascada
- “Agregue a Jane Smith a la lista Outbound Q2” — modifica una lista de graph8
- “Resume la oportunidad de Acme” — obtiene contexto de la oportunidad, notas y reuniones recientes
- “Redacta un seguimiento a mi último correo con Acme” — utiliza el historial del inbox y el contexto disponible
Actualizaciones de estado
- “¿Cómo va la campaña de Q2?” — obtiene analíticas de la campaña
- “¿Cuál es mi pipeline este trimestre?” — resumen de previsión de oportunidades
- “Muéstrame los hilos del inbox sin leer” — muestra los elementos del inbox que requieren atención
Gestión de conexiones
Consulte todas las conexiones activas en Perfil → Apps → Conexiones.
Pestaña de conexiones
La subpestaña Conexiones muestra cada conexión activa en todas las superficies:
| Columna | Descripción |
|---|---|
| Plataforma | WhatsApp, Slack, Roam, iMessage, MCP o clave de API |
| Identificador | Número de teléfono, ID de usuario, grupo o correo electrónico |
| Conectado | Fecha de conexión |
| Última actividad | Última vez que un mensaje se enrutó a través de esta conexión |
| Estado | Activo o vencido |
Desconectar
Haga clic en Desconectar junto a cualquier conexión para eliminarla. La desconexión es inmediata:
- Sus mensajes dejan de enrutarse a Copilot
- El historial de chat se conserva
- El registro de la conexión se elimina
Reconectar
Si el token OAuth de una plataforma vence, la conexión aparece como Vencida. Haga clic en Reconectar para actualizar las credenciales sin perder el historial de chat.
Historial de chat
Cada conversación de bridge se guarda como una sesión de chat persistente en graph8.
Dónde encontrarlo
- Abra la barra lateral de Copilot (en cualquier página de graph8)
- Cambie a la pestaña Historial
- Filtre por Modo Bridge para ver únicamente las sesiones de bridge
- Haga clic en cualquier sesión para ver el historial completo de mensajes
Las sesiones están organizadas por plataforma: su historial de WhatsApp es independiente de su historial de Slack.
Privacidad
Las sesiones de bridge están limitadas a su usuario: solo usted puede ver su historial de chat de bridge. Los administradores no pueden acceder a las conversaciones de bridge de usuarios individuales sin una elevación de permisos explícita.
Seguridad de webhooks
Cada plataforma utiliza su propia verificación de firma. graph8 rechaza los payloads de webhook que no superen la verificación.
| Plataforma | Verificación |
|---|---|
Firma HMAC-SHA256 en el encabezado X-Hub-Signature-256 (secreto GOWA) | |
| Slack | Firma HMAC-SHA256 con marca de tiempo (secreto de firma de Slack) |
| Roam | HMAC de Svix (x-svix-signature, x-svix-timestamp, x-svix-id) |
| iMessage | Validación de contraseña interna (servidor BlueBubbles) |
Los secretos de webhook se configuran a nivel de organización. Si autohospeda alguno de estos servicios (GOWA para WhatsApp, BlueBubbles para iMessage), mantenga los secretos rotados y almacénelos en un gestor de secretos.
Disponibilidad de herramientas
Bridge expone el conjunto completo de herramientas de Copilot:
| Categoría de herramienta | Ejemplos |
|---|---|
| Búsqueda | Búsqueda de contactos, búsqueda de empresas, búsqueda de oportunidades, búsqueda en inbox |
| CRUD | Crear contacto, actualizar etapa de oportunidad, agregar a lista, agregar a secuencia |
| Enriquecimiento | Enriquecimiento de contacto individual, búsqueda de personas |
| Analíticas | Previsión de pipeline, rendimiento de campañas, estadísticas de secuencias |
| Investigación web | Búsqueda web de empresas, consultas competitivas (solo nivel de modelo Deep) |
| Acciones | Ejecutar una Skill, enviar un correo electrónico, redactar un mensaje |
Las herramientas que requieren confirmación explícita (como enviar un correo electrónico o modificar una oportunidad) le solicitan aprobación en el hilo de chat antes de ejecutarse.
Privacidad y auditoría
| Aspecto | Comportamiento |
|---|---|
| Alcance por usuario | Cada conexión de bridge está vinculada a un usuario; sus consultas solo acceden a los datos para los que tiene permiso |
| Aislamiento de organización | Los números de teléfono se asocian a una sola organización; el enrutamiento de mensajes entre inquilinos es imposible |
| Registro de auditoría | Cada acción de bridge queda registrada en Configuración → Actividad, con plataforma, mensaje, llamadas a herramientas y costo en créditos |
| Retención de mensajes | Las sesiones de chat se conservan 90 días de forma predeterminada; configurable en Configuración → Cumplimiento |
| Eliminación de datos | Al desconectar una plataforma se elimina el registro de conexión, pero se conserva el historial de chat (eliminable por separado desde el historial de Copilot) |
Coincidencia automática (próximamente)
Una mejora futura permitirá asociar automáticamente a los usuarios con sus conexiones de bridge comparando su correo de plataforma (por ejemplo, el correo del espacio de trabajo de Slack) con su correo de graph8 en PropelAuth. Esto elimina el paso manual de selección de usuario. Hasta que esté disponible, deberá seleccionar manualmente su usuario de Slack o grupo de Roam durante la configuración.
Buenas prácticas
- Una plataforma por caso de uso: no conecte las cuatro si solo utiliza una. Cada conexión consume créditos al enrutar un mensaje
- Pruebe después de configurar: envíe un mensaje de “hola” para confirmar que el enrutamiento funciona antes de depender de él
- Reconéctese trimestralmente: los tokens OAuth de Slack y Roam pueden vencer; actualícelos de forma proactiva para evitar interrupciones durante una conversación
- Use Slack para contextos de equipo: los mensajes directos de Slack conservan mejor el hilo de conversación que WhatsApp/SMS
- Use WhatsApp/iMessage para flujos de trabajo móviles: cuando no tiene acceso a un escritorio, estas opciones son más rápidas que abrir el panel
Solución de problemas
| Problema | Causa probable | Solución |
|---|---|---|
| Los mensajes no se redirigen a Copilot | Conexión vencida o secreto de webhook incorrecto | Verifique el estado Vencida en Perfil → Apps → Conexiones; reconéctese |
| Se conectó a la organización incorrecta | El enrutamiento por número de teléfono se asigna a una sola organización | Desconéctese primero de la organización incorrecta y luego reconéctese desde la correcta |
| El selector de Slack no muestra mi usuario | El correo del espacio de trabajo de Slack difiere del correo de graph8 | Reconecte Slack y utilice el selector manual |
| Los mensajes de WhatsApp se devuelven al remitente | Bucle de webhook de GOWA mal configurado | Contacte al administrador: la URL del webhook del lado del servidor requiere ajuste |
| La conexión con Roam falló | Conectado antes de marzo de 2026 (permisos desactualizados) | Desconéctese y vuelva a conectarse para obtener los nuevos permisos |
| Entrega de iMessage con retraso | Latencia del servidor BlueBubbles | iMessage autohospedado depende de APNs de Apple; la entrega puede ser lenta durante interrupciones de APNs |
| OAuth de Slack falla | El bot fue desinstalado del espacio de trabajo | Solicite a un administrador del espacio de trabajo que vuelva a autorizar la aplicación de Slack de graph8 |
Relacionado
- Copilot →: asistente de IA integrado en la aplicación (las mismas herramientas, en el panel)
- Agentes de voz con IA →: agentes telefónicos impulsados por IA
- Skills →: capacidades de IA reutilizables que utiliza Copilot
- Integraciones →: notificaciones de Slack a nivel de espacio de trabajo y sincronización de reuniones de Roam