Plugins e Integraciones

Una integración (también le decimos plugin) le agrega a la plataforma una capacidad que no trae de fábrica: saber la hora, consultar la tasa del BCV, agendar en Google Calendar, verificar un pago móvil. La instalas una vez y a partir de ahí sus acciones aparecen en dos lugares: como paso dentro de una automatización y, sobre todo, como herramienta que tu agente IA puede usar solo, sin que tú armes el flujo paso por paso.

Por ejemplo: instalas Google Calendar, conectas tu cuenta y le das esa herramienta a tu agente autónomo. Cuando un cliente escribe «¿tienen espacio el jueves a las 3?», el agente consulta tu disponibilidad real, responde y, si el cliente confirma, crea el evento. Tú no armaste ese diálogo: le diste la herramienta y el agente decidió cuándo usarla.

Catálogo de Integraciones con plugins instalables como Fecha y Hora, Tasa BCV, Google Calendar y BDV Pago Móvil — Ajustes → Integraciones: el catálogo completo. Cuatro integraciones hoy: dos utilidades (Fecha y Hora, Tasa BCV), una que conecta un servicio externo (Google Calendar) y una que valida pagos (BDV Pago Móvil). Click para ampliar.

¿Buscas el paso a paso de una integración concreta? En la sección Guías está el tutorial completo de validar Pago Móvil BDV con un agente IA, con capturas reales y PDF descargable. Ese mismo tutorial lo abres desde el botón Guía que aparece en la tarjeta de la integración dentro del panel.

Qué hace una integración

Cada integración trae una o varias acciones. La de Google Calendar, por ejemplo, trae seis: crear evento, consultar disponibilidad, ver próximos eventos, buscar, modificar y eliminar. Una vez que la integración está instalada y habilitada, esas acciones quedan disponibles en dos superficies:

En el editor de automatizaciones — al agregar un paso aparece la categoría Integraciones con las acciones de todo lo que tengas instalado. El paso se ejecuta en su turno, como cualquier otro.
Como herramienta de un agente IA — dentro del bloque Herramientas del agente, agrupadas bajo Integraciones. Aquí no decides tú cuándo se ejecutan: el agente lee para qué sirve cada una y la invoca cuando le hace falta.

El segundo uso es el importante. Es lo que convierte a un bot que responde texto en un asistente que consulta tu calendario, verifica un pago o te dice la tasa del día antes de cotizar.

No es una tienda de apps abierta. El catálogo lo publica el equipo de artificialic: no hay integraciones de terceros ni un botón para crear la tuya desde el panel. Lo que sí puedes hacer tú: instalar, cargar credenciales, habilitar, deshabilitar y desinstalar. Si necesitas conectar tu propio sistema, mira la sección de integraciones a medida.

Las integraciones disponibles

Hoy el catálogo tiene cuatro. Ni más ni menos:

Fecha y Hora — devuelve la fecha, la hora, el día de la semana y la marca de tiempo en la zona horaria que le indiques (por ejemplo America/Bogota o America/Caracas). No pide credenciales. Suena tonta, pero es de las más útiles: un modelo de IA no sabe qué día es hoy salvo que se lo digas, y sin eso interpreta mal cosas como «mañana» o «el viernes».
Tasa BCV — consulta la página del Banco Central de Venezuela y devuelve la tasa del dólar y la del euro, con la fecha de consulta. Tampoco pide credenciales. Sirve para cotizar en bolívares al cambio del día sin que nadie lo actualice a mano.
Google Calendar — crear evento, consultar disponibilidad en un rango, listar los próximos eventos, buscar por texto, modificar y eliminar. No se carga ninguna clave: se conecta con el botón Conectar cuenta, que te lleva a Google a autorizar el acceso.
BDV Pago Móvil — siete acciones para verificar de punta a punta un pago móvil del Banco de Venezuela: abrir una sesión de validación con el monto esperado, leer el número de referencia desde la foto del comprobante usando un modelo con visión, buscarlo en los movimientos del banco, listar el estado de cuenta de una fecha, conciliar contra la API del BDV cuando la búsqueda no lo encuentra, consultar en qué punto va la sesión y marcarla como fallida. Es la única que pide credenciales completas: clave de la API de conciliación, teléfono destino, RIF de la empresa, cuenta de movimientos, cuánto dura la sesión y qué modelo de IA lee los comprobantes.

El buscador de la pestaña Explorar filtra por nombre y descripción. No hay categorías ni filtros: con cuatro integraciones, el buscador alcanza.

Instalar y conectar

La sección se llama Integraciones y vive en Ajustes → Integraciones. Tiene dos pestañas: Explorar (el catálogo) e Instalados (lo tuyo).

Entra a Ajustes → Integraciones. Caes en Explorar.
Busca la integración por nombre y toca Instalar.
Si pide credenciales, se abre un formulario en el mismo diálogo. Llénalo y confirma. Si no pide nada, solo confirmas.
Pasa a la pestaña Instalados: ahí está tu integración con un interruptor de encendido, la versión y el menú ⋮.
Con Google Calendar hay un paso extra: en vez de un formulario aparece el botón Conectar cuenta. Te lleva a Google, autorizas y vuelves. Cuando quedó bien verás la insignia verde Conectado y el botón pasa a decir Reconectar.

En Instalados, el menú ⋮ tiene dos opciones: Configurar credenciales (solo si la integración usa claves) y Desinstalar. El interruptor de al lado la habilita o deshabilita sin borrar nada.

Al reconfigurar credenciales, reescribe todos los campos. Por seguridad, las claves guardadas no se muestran nunca: el formulario se abre vacío y guarda exactamente lo que dejaste escrito. Si solo llenas el campo que querías cambiar, los demás se guardan en blanco y la integración deja de funcionar. Ten a mano todos los valores antes de abrir ese diálogo.

Deshabilitar no es lo mismo que desinstalar. El interruptor apagado conserva las credenciales y la puedes volver a prender cuando quieras — pero ojo: mientras esté apagada, los pasos y las herramientas que la usen fallan, no se saltan. Desinstalar borra las credenciales y deja rotas las automatizaciones que dependían de ella; el propio diálogo de desinstalación te lo advierte.

Usarlas como paso de una automatización

En el editor de automatizaciones, cuando agregas un paso aparece la categoría Integraciones (el icono de la pieza de rompecabezas), con las acciones de todo lo que tengas instalado y habilitado. Eliges una, la configuras y queda como un paso más del flujo.

Lo interesante es lo que devuelve. Cada acción entrega un puñado de datos de salida que puedes reutilizar en los pasos siguientes como variables:

Tasa BCV devuelve la tasa del dólar, la del euro y la fecha.
Fecha y Hora devuelve fecha, hora, fecha y hora juntas, día de la semana, zona horaria y marca de tiempo.
Crear evento de Google Calendar devuelve el identificador del evento y su enlace — con eso el siguiente paso puede mandarle el link al cliente por WhatsApp.
Buscar en movimientos del BDV devuelve si encontró el pago, si el monto coincide, el monto confirmado, el monto esperado y la fecha del movimiento — perfecto para ramificar el flujo con una condición.

Si la acción falla (la cuenta de Google se desconectó, el banco no responde, la integración está deshabilitada), el paso queda marcado como fallido con el mensaje de error concreto en la pestaña Registro de ejecuciones del editor. Es el primer lugar donde mirar cuando algo «no hizo nada».

Dejar que el agente IA las use solo

Este es el uso que le sacamos más provecho. Un agente autónomo (y también un agente de voz) puede tener herramientas conectadas y decidir por su cuenta cuál usar y cuándo. Los agentes de chat comunes no invocan herramientas: para esto necesitas el autónomo.

En tu automatización, agrega el paso Agente IA (Autónomo) y conéctale un modelo.
En el bloque Herramientas del agente, toca Añadir herramienta. Las acciones de tus integraciones aparecen agrupadas bajo Integraciones.
La herramienta se crea ya lista: el interruptor Usar como herramienta viene encendido y trae escrita una Descripción para la IA de fábrica.
Ajusta esa descripción si hace falta. Es literalmente lo único que el modelo lee para decidir si esa herramienta le sirve, así que escríbela orientada a la acción: cuándo usarla y qué devuelve.
Decide qué campos rellena la IA. Los que dejas en blanco se convierten en parámetros que el modelo completa con lo que descubre en la conversación (la referencia del pago, la fecha que pidió el cliente). Los que fijas con un valor o una variable el modelo no los toca.

Las credenciales de la integración nunca se le ofrecen al modelo: viajan por debajo, desde la instalación, y el agente no las ve ni las puede pedir.

Si una herramienta falla, el agente recibe el texto del error como respuesta y sigue la conversación: puede reintentar, pedirle al cliente el dato que faltaba o avisarle que hubo un problema. La conversación no se corta.

Un ejemplo completo, con capturas. La guía de Pago Móvil BDV recorre exactamente este camino: instalar, cargar credenciales, crear el agente autónomo, añadirle las herramientas del banco, escribir las descripciones para la IA y probarlo en el chat de prueba antes de activarlo. Si vas a montar tu primera integración con IA, sigue esa.

Integraciones a medida (webhook)

Una integración puede estar construida de dos maneras: con código que corre dentro de la plataforma (así son las cuatro actuales) o apuntando a una URL tuya. A esa segunda forma le decimos integración por webhook, y es el camino para conectar tu propio sistema: tu ERP, tu inventario, tu pasarela.

Así funciona, para que se lo pases a tu desarrollador:

Cuándo se llama — cuando el paso se ejecuta en la automatización, o cuando el agente IA decide invocar esa herramienta. No es un aviso de «pasó algo»: es una llamada puntual con una pregunta concreta.
Qué se envía — un POST con un paquete JSON que incluye lo que configuraste en el paso, los datos del contacto, de tu organización, de la conversación y del mensaje que disparó el flujo, las salidas de los pasos anteriores y las credenciales que cargaste al instalar.
Cómo verificar que somos nosotros — si la integración tiene un secreto configurado, la llamada viaja con la cabecera X-Plugin-Signature: una firma HMAC-SHA256 del cuerpo exacto del mensaje. Recalculas y comparas.
Qué debes responder — un JSON con success y, si todo salió bien, un output con los datos que quedarán disponibles para los pasos siguientes o que leerá el agente IA. Opcionalmente puedes pedir efectos: actualizar el contacto o enviar un mensaje al cliente.

Es una llamada sincrónica y no hay reintentos. La automatización se queda esperando tu respuesta, así que tienes 30 segundos. Si tardas más, si tu servidor responde un error o si se cae la conexión, el paso falla ahí mismo y queda registrado como fallido. No lo volvemos a intentar. Si tu proceso es lento, responde rápido con un acuse y haz el trabajo pesado por tu lado.

Esto no son «los webhooks» de la API. Son dos cosas distintas y se confunden fácil. Lo de esta página es una llamada que tu automatización le hace a tu sistema y cuya respuesta espera. Los webhooks de eventos son al revés: nosotros te avisamos cuando pasa algo en la plataforma (mensaje entrante, cambio de estado de entrega, conversación nueva, cambio de asignación, cambio de modo de atención, difusión finalizada), son asincrónicos, tienen 10 segundos de plazo, se reintentan hasta 5 veces y se configuran en Ajustes → API. Están documentados en API REST → Webhooks salientes.

Publicar una integración nueva en el catálogo (con webhook o con código) lo hace hoy el equipo de artificialic: no existe un botón Crear plugin en tu panel. Si tienes un sistema propio que quieres conectar, cuéntanos qué acciones necesitas y qué datos devuelve tu API, y la publicamos.

Límites y detalles que conviene saber

Una instalación por organización. Si intentas instalar dos veces la misma integración, te avisa que ya está instalada. Las credenciales se cambian desde Configurar credenciales, no reinstalando.
Las credenciales se guardan cifradas y no se vuelven a mostrar. Ni tú ni el agente IA las ven después de guardarlas.
Quién puede tocar esto. La pestaña Integraciones solo aparece si tu rol tiene permiso sobre integraciones. Lo configuras en Ajustes → Roles y permisos.
Deshabilitada = falla, no se salta. Vale la pena repetirlo: apagar el interruptor de una integración que está en uso rompe esos pasos.
El nombre en el menú es «Integraciones». Aunque en la documentación y en el editor también leas «plugins», en el panel la sección se llama así y vive dentro de Ajustes, no en el menú lateral principal.