Plugins e Integraciones

Los plugins te permiten extender las funcionalidades de artificialic conectando con servicios externos como CRMs, ERPs, pasarelas de pago y más.

Explorar el marketplace

El marketplace es la tienda de plugins disponibles para tu organización. Aquí encontrarás integraciones oficiales y de terceros organizadas por categoría:

  • CRM: sincroniza contactos y datos de clientes.
  • E-commerce: conecta tu tienda online para notificaciones de pedidos.
  • Productividad: integra con herramientas de gestión de tareas.
  • Pagos: envía enlaces de pago directamente en conversaciones.

Instalar plugins

  1. Ve a Plugins en el menú lateral.
  2. Explora el marketplace o busca por nombre.
  3. Haz clic en el plugin que te interese para ver sus detalles.
  4. Haz clic en Instalar.
  5. Configura las credenciales o parámetros que requiera el plugin.
  6. Activa el plugin.

Consejo: puedes desactivar un plugin en cualquier momento sin desinstalarlo. Esto pausa su funcionamiento pero conserva su configuración.

Crear un plugin propio

Si necesitas una integración personalizada, puedes crear tu propio plugin:

  1. Haz clic en Crear plugin en la página de plugins.
  2. Define el nombre y descripción del plugin.
  3. Configura los webhooks: URL de destino, eventos que lo disparan y método HTTP.
  4. Opcionalmente, agrega código personalizado para transformar los datos antes de enviarlos.
  5. Guarda y activa.

API de plugins

Los plugins pueden recibir y enviar datos mediante webhooks HTTP. Cuando ocurre un evento en artificialic (nuevo mensaje, conversación cerrada, etc.), el sistema envía un payload JSON al endpoint configurado:

  • Eventos disponibles: nuevo mensaje, mensaje enviado, conversación creada, conversación cerrada, contacto creado.
  • Formato: JSON con la información del evento, contacto y conversación.
  • Autenticación: cada plugin recibe un token único para verificar la autenticidad de las llamadas.

Importante: los webhooks tienen un timeout de 10 segundos. Si tu servicio no responde en ese tiempo, el envío se reintentará hasta 3 veces con backoff exponencial.