saltar al contenido principal
Explorar la documentación

Conexiones

Todo lo que une Syncanix con algo más: dónde puede cargarse el widget, adónde se envían los eventos, tu propio dominio, la URL de tu servidor MCP y tu propio proveedor de IA.

Cinco áreas en una página, cada una con su pestaña. No tienen nada en común técnicamente: están juntas porque todas responden a «¿cómo llega esto a algo fuera de Syncanix?», que es la pregunta de quien viene a buscarlas.

Dónde puede cargarse el widget

El widget solo se carga en un sitio que hayas listado aquí. Esto es lo que impide que tu clave publicable sirva a quien la copie en su propia página.

  • Una entrada es un esquema y un host, nada más: incluir https://shop.example.com cubre todas sus páginas.
  • Añade también tus hosts de staging y de vista previa, o el widget no se cargará mientras pruebas.
  • Eliminar un origen surte efecto de inmediato y detiene el widget en ese sitio.

Recibir eventos en tus propios sistemas

Un destino de webhook es una URL de tu lado a la que Syncanix envía eventos: una conversación traspasada a una persona, un hallazgo de cumplimiento, una propuesta a la espera de revisión. Así lo que ocurre aquí aparece en tus propias alertas, tu cola de tickets o tu almacén de datos.

  1. Indica una URL accesibleSyncanix envía peticiones a ella, así que debe ser accesible desde internet por HTTPS. Una URL tras una VPN sencillamente nunca recibirá nada.
  2. Elige los eventos, con criterioEmpieza solo con lo que vayas a atender y añade más después. Un destino suscrito a todo se convierte en ruido que alguien acaba silenciando, lo cual es peor que no tenerlo.
  3. Copia el secreto de firmaSe muestra exactamente una vez, y con él verificas cada entrega para que tu endpoint distinga un evento real de cualquier otra cosa que encuentre la URL. Rotarlo surte efecto de inmediato: tu endpoint rechazará entregas hasta que despliegues con el nuevo.

Servir desde tu propio dominio

Puedes servir el widget desde un nombre de host propio para que los visitantes nunca vean una URL de Syncanix. Introduce el nombre, añade el registro DNS que se muestra y la verificación se ejecuta sola: los cambios de DNS tardan en llegarnos, así que la página sigue comprobando en vez de pedírtelo. El certificado HTTPS se emite y renueva por ti en cuanto el registro se verifica.

La URL de tu servidor MCP

Cada espacio de trabajo tiene su propia URL para conectar un cliente de IA. La pestaña la contiene junto con tarjetas de configuración listas para los clientes habituales, y es también donde registras un servidor MCP que ya ejecutes para que sus herramientas aparezcan junto a las tuyas.

Usar tu propio proveedor de IA

Añade tu propia clave de proveedor o apunta Syncanix a un despliegue que ejecutes tú. En ambos casos las peticiones van bajo tu propio acuerdo con ese proveedor y nunca a través de una cuenta de Syncanix, tu proveedor te factura la inferencia y nosotros dejamos de cobrar por esos tokens. Si tu proveedor rechaza la clave, el estado aquí lo indica: las conversaciones no vuelven en silencio a la nuestra.

Próximos pasos