Saltearse al contenido

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:

FuncionalidadUbicaciónQué hace
Copilot BridgePerfil → AppsRedirige sus mensajes directos a Copilot para búsquedas con IA, oportunidades y enriquecimiento
Configuración → Integraciones → SlackConfiguraciónEnvía notificaciones y alertas de graph8 a canales
Configuración → Integraciones → RoamConfiguraciónSincroniza 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

PlataformaCómo funcionaIdentificador
WhatsAppEnvíe un mensaje a su número de teléfono conectado; las respuestas se redirigen a CopilotNúmero de teléfono (solo dígitos)
SlackEnvíe un mensaje directo al bot de graph8 en su espacio de trabajoID de usuario de Slack
RoamEnvíe un mensaje en un grupo conectado o por mensaje directoID de usuario/grupo de Roam
iMessageEnvíe un mensaje a su número de teléfono o correo electrónico conectadoNúmero de teléfono o correo electrónico

Configuración de una conexión

  1. Vaya a Perfil → Apps
  2. Abra la subpestaña Configuración
  3. Localice en Mensajería la plataforma que desea conectar
  4. 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.

WhatsApp

  1. Haga clic en la tarjeta de WhatsApp e ingrese su número de teléfono (solo dígitos, con código de país)
  2. Haga clic en Conectar
  3. 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

  1. Haga clic en Conectar Slack
  2. Autorice el bot de graph8 en su espacio de trabajo de Slack (flujo OAuth)
  3. Tras la autorización, seleccione su usuario de Slack en la lista de usuarios del espacio de trabajo
  4. 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

  1. Haga clic en Conectar Roam
  2. Inicie sesión en Roam y autorice a graph8
  3. Seleccione un grupo de Roam o un mensaje directo personal como destino de enrutamiento
  4. 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

  1. Haga clic en Conectar iMessage
  2. Ingrese su número de teléfono o dirección de correo electrónico
  3. 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:

ColumnaDescripción
PlataformaWhatsApp, Slack, Roam, iMessage, MCP o clave de API
IdentificadorNúmero de teléfono, ID de usuario, grupo o correo electrónico
ConectadoFecha de conexión
Última actividadÚltima vez que un mensaje se enrutó a través de esta conexión
EstadoActivo 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

  1. Abra la barra lateral de Copilot (en cualquier página de graph8)
  2. Cambie a la pestaña Historial
  3. Filtre por Modo Bridge para ver únicamente las sesiones de bridge
  4. 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.

PlataformaVerificación
WhatsAppFirma HMAC-SHA256 en el encabezado X-Hub-Signature-256 (secreto GOWA)
SlackFirma HMAC-SHA256 con marca de tiempo (secreto de firma de Slack)
RoamHMAC de Svix (x-svix-signature, x-svix-timestamp, x-svix-id)
iMessageValidació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 herramientaEjemplos
BúsquedaBúsqueda de contactos, búsqueda de empresas, búsqueda de oportunidades, búsqueda en inbox
CRUDCrear contacto, actualizar etapa de oportunidad, agregar a lista, agregar a secuencia
EnriquecimientoEnriquecimiento de contacto individual, búsqueda de personas
AnalíticasPrevisión de pipeline, rendimiento de campañas, estadísticas de secuencias
Investigación webBúsqueda web de empresas, consultas competitivas (solo nivel de modelo Deep)
AccionesEjecutar 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

AspectoComportamiento
Alcance por usuarioCada conexión de bridge está vinculada a un usuario; sus consultas solo acceden a los datos para los que tiene permiso
Aislamiento de organizaciónLos números de teléfono se asocian a una sola organización; el enrutamiento de mensajes entre inquilinos es imposible
Registro de auditoríaCada acción de bridge queda registrada en Configuración → Actividad, con plataforma, mensaje, llamadas a herramientas y costo en créditos
Retención de mensajesLas sesiones de chat se conservan 90 días de forma predeterminada; configurable en Configuración → Cumplimiento
Eliminación de datosAl 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

ProblemaCausa probableSolución
Los mensajes no se redirigen a CopilotConexión vencida o secreto de webhook incorrectoVerifique el estado Vencida en Perfil → Apps → Conexiones; reconéctese
Se conectó a la organización incorrectaEl enrutamiento por número de teléfono se asigna a una sola organizaciónDesconéctese primero de la organización incorrecta y luego reconéctese desde la correcta
El selector de Slack no muestra mi usuarioEl correo del espacio de trabajo de Slack difiere del correo de graph8Reconecte Slack y utilice el selector manual
Los mensajes de WhatsApp se devuelven al remitenteBucle de webhook de GOWA mal configuradoContacte 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 retrasoLatencia del servidor BlueBubblesiMessage autohospedado depende de APNs de Apple; la entrega puede ser lenta durante interrupciones de APNs
OAuth de Slack fallaEl bot fue desinstalado del espacio de trabajoSolicite 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