Plugins e Integraciones
Un plugin es una pieza enchufable que conecta la plataforma con otro sistema que ya usas (tu CRM, tu tienda online, tu pasarela de pagos). Funciona como un cable de extensión: en un extremo está la plataforma, en el otro está el sistema externo, y el plugin pasa la información de un lado al otro.
Por ejemplo: cuando un cliente nuevo te escribe por WhatsApp, un plugin de CRM puede crear automáticamente la ficha del cliente en HubSpot. Tú no haces nada, sucede solo.
Explorar el marketplace
El marketplace es la tienda de plugins disponibles, parecido a una tienda de apps en el celular. Cada plugin viene con una breve descripción de qué hace y a qué servicio se conecta. Están organizados por categoría:
- CRM — sistemas que organizan a tus clientes (HubSpot, Salesforce, Pipedrive). El plugin sincroniza contactos.
- E-commerce — tiendas online (Shopify, WooCommerce). El plugin avisa cuándo hay pedidos nuevos.
- Productividad — herramientas para gestionar tareas (Trello, Asana). El plugin crea tarjetas o tareas a partir de conversaciones.
- Pagos — pasarelas como Mercado Pago, Stripe. El plugin manda enlaces de pago directo en el chat.
Instalar plugins
- Ve a Plugins en el menú lateral.
- Explora el marketplace o busca por nombre.
- Haz clic en el plugin que te interese para ver sus detalles.
- Haz clic en Instalar.
- Configura las credenciales o parámetros que requiera el plugin.
- 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
Esta sección está pensada para tu desarrollador (o para ti, si te animas a meter las manos en código). Si lo único que quieres es usar una integración existente, basta con instalar la del marketplace.
Si necesitas algo a medida, puedes crear tu propio plugin que conecte con tu sistema interno:
- En la página de plugins, haz clic en Crear plugin.
- Ponle un nombre y una descripción.
- Configura los webhooks: la URL de destino, qué eventos lo disparan y qué método HTTP usar. (Más sobre webhooks abajo.)
- Opcionalmente, agrégale código que transforme los datos antes de enviarlos.
- Guarda y activa.
Cómo se comunican los plugins (webhooks)
Los plugins se comunican con tu sistema externo a través de webhooks. Un webhook es simplemente una URL tuya a la que la plataforma le envía un mensaje cada vez que pasa algo importante. Tu sistema escucha en esa URL y reacciona.
Una analogía: piensa los webhooks como un timbre. Tú le dices a la plataforma «si pasa X, toca este timbre» y le das tu dirección (la URL). Cuando pasa X, la plataforma toca el timbre y te enteras al instante. No tienes que estar revisando todo el tiempo si pasó algo.
Cuando se dispara, la plataforma le envía un payload (palabro técnico para «paquete de datos», generalmente en formato JSON) con toda la información del evento.
- Eventos disponibles — nuevo mensaje, mensaje enviado, conversación creada, conversación cerrada, contacto creado.
- Formato — JSON con la info del evento, del contacto y de la conversación.
- Autenticación — cada plugin tiene un token único para que tu sistema verifique que el aviso vino realmente de nosotros y no de un tercero malicioso.
Importante: tu URL tiene 10 segundos para responder. Si no contesta en ese tiempo, el envío se considera fallido. Lo reintentamos hasta 3 veces con backoff exponencial (esperando un poco más cada vez: si el primer reintento es a los 10 segundos, el segundo es a los 30, el tercero a los 90 — para no saturar tu sistema si está caído). Después de 3 intentos fallidos, ese aviso se descarta.