Integraciones
Conecta el bot con Google Sheets, Drive, GetCourse o una IA: dónde guardar el acceso y qué acción añadir a la reacción.
En esta página
Una integración permite que el bot trabaje con otro servicio, por ejemplo, añadir una solicitud a Google Sheets o enviar los datos de un cliente a GetCourse. La configuración tiene dos partes: primero guarda la conexión y luego selecciónala en una acción de la reacción.
Abre Integraciones → Agregar integración, elige el servicio y rellena sus campos. Los datos de acceso se guardan cifrados. En la tarjeta de la conexión puedes activarla, desactivarla o abrirla con Configurar.
Servicios disponibles
- IA: modelo de lenguaje con una API compatible con OpenAI. Consulta Respuestas con IA y agentes.
- Google Sheets: añadir, leer, buscar y actualizar filas mediante los encabezados de columna. Consulta Acciones.
- Google Drive: subir archivos a una carpeta.
- GetCourse: crear y actualizar usuarios y negocios; exportar usuarios, negocios y grupos.
- Webhook: enviar datos por HTTP a la dirección de otro servicio.
- Procesador externo: pasar una reacción a tu programa en un servidor mediante una conexión WebSocket persistente. Consulta Procesador externo.
Google Calendar también puede conectarse, pero desde otra pantalla: usa OAuth en AI → Calendario, donde también se configuran los tipos de cita. Consulta Citas y Google Calendar.
Para los CRM amoCRM/Kommo, Bitrix24, RetailCRM y OzmaCRM existe Integraciones → CRM. Allí puedes conectar el sistema, asociar sus campos a los de GetMyBot, previsualizar el resultado antes de empezar, revisar el registro de sincronización y resolver conflictos. Los datos se transmiten en ambos sentidos. amoCRM/Kommo usan OAuth; RetailCRM, una clave API; OzmaCRM, OIDC; y Bitrix24, un webhook entrante del portal. Los pasos están en Integraciones CRM.
Configuración
Al añadir una integración, elige el Servicio, asigna un Nombre a la conexión y completa los campos del servicio elegido:
Webhook
- URL del webhook: dirección que recibe los datos.
- Firma HMAC: clave secreta compartida con la que el servicio receptor puede verificar que la solicitud proviene de GetMyBot. La firma se envía en el encabezado
X-Signature: sha256=....
GetCourse
- Cuenta: identificador de la escuela, por ejemplo
myschool, y Clave secreta de la API. - Objeto: Usuarios o Negocios.
La acción GetCourse permite dos tipos de trabajo.
Importar en GetCourse. Los campos se agrupan como en la API oficial: User (email, phone, first_name, last_name, city, country, group_name), Import settings (por ejemplo, refresh_if_exists), Traffic source (utm_source, utm_campaign, referer), Deal (offer_code, deal_cost, deal_status, deal_is_paid) y Custom user fields. Puedes tomar un valor de los datos del cliente, por ejemplo, email = {{param.email}}, o introducir uno fijo, como utm_source = telegram. Las sugerencias de grupos y campos adicionales se cargan desde tu cuenta; si fallan, introduce sus nombres manualmente. Las acciones antiguas con una lista única de campos siguen funcionando. Convert to sections distribuye las claves conocidas entre las secciones y deja el resto en campos adicionales.
Si GetCourse devuelve HTTP 200 pero indica success: false, la acción falla y muestra error_message. Si tiene éxito, los ID {user_id, deal_id, lead_id} se guardan en los datos temporales de la reacción; los valores que falten quedan en cero.
Obtener datos de GetCourse. Export users, Export deals y Export groups inician una exportación en GetCourse y esperan hasta 25 segundos. Si los datos aún no están listos, la acción falla con export_not_ready: vuelve a intentarlo más tarde o usa un filtro más estrecho. Un filtro se compone de filas «clave, tipo, valor», por ejemplo created_at[from] = 2026-10-01; las claves desconocidas se envían sin modificar. El resultado es una lista con los nombres de campo de la cuenta, de hasta 1000 filas por ejecución (50 por defecto). has_more en Page details indica si queda otra parte. GetCourse limita la frecuencia de exportación: no la ejecutes por cada mensaje, sino en escenarios poco frecuentes o programados.
Google Sheets
- Enlace a la hoja de cálculo, o su ID.
- JSON de cuenta de servicio: archivo secreto que contiene la clave de una cuenta de Google separada para el programa. Comparte la hoja con la dirección de correo de esa cuenta. Si no lo haces, tanto la lectura como la escritura fallarán por falta de acceso; el error aparece en el editor de la acción y durante la comprobación.
Los campos de la acción se corresponden con los encabezados de columna de una fila de encabezados, por defecto la primera. Puedes seleccionar otra fila. Las operaciones son:
- Append a row: escribe cada campo en la columna con el mismo encabezado; el orden de las columnas no importa. Un encabezado desconocido provoca un error. Resultado:
{row_number, range}. - Read rows: devuelve como objetos las filas posteriores a los encabezados, junto con su número
_row. La página contiene 50 filas por defecto y 500 como máximo;has_moreynext_offsetpueden guardarse en una clave aparte. - Read the last row y Find a row by column value: recorren la hoja por páginas y fallan si es demasiado grande, en lugar de devolver una fila equivocada.
- Update a row: modifica las celdas de
row_number, por ejemplo{{ctx.found.row_number}}después de una búsqueda.
Puedes escribir los valores As typed (formulas and dates are parsed), para que Google Sheets reconozca fórmulas y fechas, o Raw text, sin ese reconocimiento. El editor propone los encabezados de la hoja como nombres de campo; si no logra leerlos, puedes introducirlos manualmente. Preview rows muestra hasta 20 filas y no modifica la hoja. Puedes usarla como ejemplo para el Parse response, que selecciona los campos necesarios para la siguiente acción.
Google Drive
- ID de carpeta.
- JSON de cuenta de servicio, un secreto. Da a esa cuenta permiso para editar la carpeta.
La acción Google Drive sube un archivo con nombre, tipo MIME y contenido. Guarda {file_id, web_view_link} en los datos temporales de la reacción, por ejemplo bajo la clave upload. Después puedes insertar el enlace mediante {{ctx.upload.web_view_link}}. También puedes configurar el Parse response como en las demás acciones.
IA
- Base URL, Modelo, Prompt del sistema y Clave API, que es secreta. Consulta Respuestas con IA y agentes.
La misma conexión de IA sirve para la acción IA de las reacciones, el agente de IA y la preparación de las fuentes de conocimiento para la búsqueda. Al preparar la búsqueda, el modelo crea representaciones numéricas del texto llamadas embeddings. Se solicitan con la misma URL base y clave, usando por defecto el modelo text-embedding-3-small. Sin una conexión de IA que funcione, las fuentes no pueden prepararse para la búsqueda y el agente no se puede activar.
Procesador externo
Es una integración WebSocket: tu servidor se conecta a GetMyBot y procesa las reacciones devolviendo comandos con el formato de Telegram Bot API.
- URL de conexión: dirección WebSocket a la que se conecta tu servicio.
- Token: secreto que se muestra una sola vez al crearlo; puedes regenerarlo.
Consulta el protocolo y los ejemplos de servicio en Procesador externo.
Uso en reacciones
- IA y Webhook pueden usarse inmediatamente como acción o canal: añade una acción IA o envía datos a la URL del webhook con Solicitud web.
- Las acciones GetCourse, Google Sheets y Google Drive están disponibles en el editor de reacciones. Todas admiten Parse response opcional: selecciona valores del resultado y guárdalos en el contexto. Si falla la acción, se ejecuta la ruta de error configurada. Si tu plan no incluye la función, el paso falla con
feature_unavailable.
Comprobar una integración
Cada tarjeta de integración tiene un botón Check. La comprobación no escribe datos: Google Sheets lee la información de la hoja; Google Drive, la de la carpeta; GetCourse hace una consulta de lectura segura; e IA solo comprueba que estén rellenados los ajustes, sin una llamada de pago. En los demás tipos no hay nada que comprobar. El resultado indica qué verificaciones pasaron y cuáles fallaron, con una breve explicación.
Seguridad
GetMyBot no envía solicitudes de integraciones a redes internas y limita el tamaño de las respuestas. Así se evita llamar a direcciones que no están destinadas al acceso externo (SSRF). Los secretos de las integraciones se guardan cifrados.
El rastreo de sitios web y el análisis de archivos tienen restricciones adicionales: solo direcciones HTTPS permitidas, respeto de robots.txt, límites de redirecciones, tamaño y tiempo, y prohibición de ejecutar macros, scripts u objetos incrustados. Consulta Fuentes de conocimiento.
Qué sigue
- Respuestas con IA y agentes: configuración y uso del modelo.
- Fuentes de conocimiento: materiales que puede usar el agente.
- Citas y Google Calendar: conexión del calendario.
- Procesador externo: conexión de tu servidor por WebSocket.
- Integraciones CRM: amoCRM/Kommo, Bitrix24, RetailCRM y OzmaCRM.
- Fuentes y claves: conectores REST/OzmaDB para leer y escribir datos.
- Solicitudes web y webhooks: HTTP entrante y saliente.
Voz a texto
Elige un proveedor compatible con OpenAI o tu propio servicio y configura la URL base de la API, el modelo y la clave API. El código de idioma opcional, por ejemplo ru o en, sirve de pista sobre el idioma hablado; si lo dejas vacío, lo detectará el proveedor. La clave y el modelo deben corresponder al proveedor elegido.