Activar integraciones
Dónde conectar los servicios externos que usa tu app (pago, mapa, SMS, WhatsApp, avisos), qué significa cada estado de la tarjeta y qué guía seguir para cada proveedor.
La app puede tener lista la pantalla de checkout, el campo de dirección o el botón de enviar mensaje y aun así no funcionar: quien ejecuta esas acciones es el proveedor, con tu cuenta. Sin la credencial guardada, la pantalla existe y la acción no ocurre.
Dónde está
Pestaña Integraciones, en el editor. Tiene dos subpestañas:
- Proveedores: una tarjeta por servicio del catálogo, con búsqueda por nombre, los filtros Todas, Conectadas y No conectadas, y las categorías (Pagos, Ubicación, Notificaciones, Productividad y otras);
- APIs externas: para registrar una API que no está en el catálogo, con la clave guardada en el servidor y usada por una función de backend.
Dos temas parecidos viven en otras pestañas: el login social (Google, Apple, Microsoft y otros) está en Autenticación, y el dominio de envío de correo está en Dominios.
Plan
La pestaña Integraciones abre en cualquier plan, y parte de las tarjetas funciona en todos, incluido Free. Las demás requieren el plan Builder.
| Funciona en cualquier plan | Requiere el plan Builder |
|---|---|
| Google Maps | Stripe, Mercado Pago, Pagar.me y Hotmart |
| SMS (Twilio) | WhatsApp y Telegram |
| Slack y Discord | Shopify, Meta (Facebook/Instagram) y Google Workspace |
| Meta Pixel, Google Analytics, Google Tag Manager, Microsoft Clarity y Hotjar | Notion, Airtable y Mailchimp |
| Baseportal Chat, Crisp y Tawk.to | Webhook (salida) |
| Consentimiento de cookies | Google AdSense |
En los planes Free y Starter, las tarjetas que requieren Builder aparecen atenuadas, el aviso "Las integraciones son una función del plan Builder" queda arriba en la pestaña, y hacer clic en una de esas tarjetas lleva a los planes. Las demás abren y se conectan con normalidad.
La subpestaña APIs externas también es del plan Builder.
El servidor además comprueba el plan en cada uso para WhatsApp, Telegram, Shopify, Meta, Notion, Airtable, Mailchimp y Webhook (salida). Si la cuenta deja Builder, esas integraciones dejan de responder en la app publicada, aunque la credencial siga guardada.
El correo con dominio propio es un caso aparte: está en la pestaña Dominios y vale para cualquier plan de pago. Consulta Correo con dominio propio.
Cómo conectar una tarjeta
- haz clic en la tarjeta;
- completa los campos que pide (cada guía de abajo dice dónde conseguir cada uno);
- haz clic en Guardar y activar.
La plataforma guarda y, en los proveedores que lo permiten, prueba la credencial en el momento. Un campo secreto ya guardado aparece después con "· configurado" junto al nombre. Desconectar, al pie de la tarjeta, borra la credencial de la plataforma.
Para cambiar una clave de una tarjeta que ya está conectada, escribe solo ese campo y guarda. Un campo que queda en blanco conserva el valor guardado, y lo que la propia plataforma guarda (como el secreto del webhook de Stripe y el acceso autorizado de las conexiones por autorización) sigue ahí.
Las claves quedan cifradas en el servidor y nunca vuelven a la pantalla ni llegan al navegador de quien usa la app.
Qué significa cada estado
| Estado en la tarjeta | Qué significa |
|---|---|
| No conectada | no se guardó nada en esta tarjeta |
| Conectada | la credencial está guardada y, cuando el proveedor permite probarla, pasó la prueba |
| Error de configuración | la credencial está guardada, pero la prueba la rechazó (clave equivocada, caducada, sin permiso, formato inválido) |
No todas las tarjetas pueden probar la credencial al guardar, y eso cambia lo que Conectada garantiza:
- prueban de verdad, hablando con el proveedor: Stripe, Mercado Pago, Pagar.me, Hotmart y Google Maps;
- solo comprueban el formato del ID: Meta Pixel, Google Analytics, Google AdSense, Google Tag Manager, Microsoft Clarity, Hotjar y los chats (Baseportal Chat, Crisp, Tawk.to);
- solo guardan, sin prueba: SMS (Twilio), WhatsApp, Slack, Discord, Telegram, Notion, Airtable, Mailchimp, Webhook (salida), Shopify, Meta (Facebook/Instagram) y Google Workspace. En estas, Conectada significa "guardada", y la prueba de que funciona es el primer envío real.
Cuando la prueba falla, la ventana muestra "Guardado, pero la validación falló" seguido del motivo que dio el proveedor. El camino es corregir la credencial en el proveedor, no volver a pegar el mismo valor.
Claves de prueba y de producción
Varios proveedores dan dos juegos de credenciales: uno de prueba, que no mueve dinero ni entrega de verdad, y uno de producción.
- Stripe, Mercado Pago y Pagar.me no tienen botón de entorno en la tarjeta: lo que decide es qué clave pegas. Clave de prueba, cobro de prueba. Cámbialas por las de producción antes de vender;
- Hotmart tiene la opción "Usar el entorno de pruebas (sandbox)". Déjala sin marcar con credenciales de producción;
- WhatsApp y Twilio tienen límites en el modo de prueba (números de destino permitidos, token que caduca). Las guías de cada uno lo explican.
Créditos de integración
Configurar una integración no gasta ningún crédito. Lo que gasta son los créditos de integración, la moneda para hacer funcionar la app, cuando la app publicada usa el proveedor: cada SMS (incluido el código de login por SMS), cada correo de automatización o aviso enviado por la app, cada aviso en Slack o Discord, cada mensaje de WhatsApp o Telegram y cada llamada a Shopify, Meta, Notion, Airtable, Mailchimp, Webhook (salida), Google Workspace y APIs externas.
El débito solo ocurre cuando el proveedor acepta. Una llamada que falla no se cobra. Con el saldo en cero, esos envíos se rechazan hasta que vuelva a haber saldo.
Los pagos y Google Maps no consumen créditos de integración. Maps usa la cuota y la facturación de tu proyecto en Google.
El saldo y el uso del mes están en el panel, en Facturación. Consulta Créditos.
El asistente avisa lo que falta
Después de una compilación, el chat muestra la tarjeta Para que funcione de verdad, con cada integración que usa el código de la app y que todavía no está activa. Cada elemento tiene dos botones:
- Activar en Integraciones: abre la pestaña Integraciones directamente en la tarjeta de esa integración (en el caso de los pagos, en la categoría Pagos, donde eliges la pasarela);
- Cómo activar: abre la guía de ese proveedor, en esta documentación.
Cuando una integración queda activa, el asistente lo confirma en el chat.
El asistente también lee, en cada conversación, el estado de tus integraciones: cuáles están conectadas, cuáles están guardadas pero con problemas y cuáles no se conectaron. Puedes preguntar en el chat "¿Stripe está activo?". Ve el estado, nunca el valor de las claves.
Guías por proveedor
| Integración | Guía |
|---|---|
| Stripe, Mercado Pago, Pagar.me, Hotmart | Pagos |
| Google Maps | Google Maps |
| Correo con tu dominio | Correo con dominio propio |
| SMS (Twilio) | SMS con Twilio |
| Shopify, Meta (Facebook/Instagram), Google Workspace | Conexiones por autorización |
| Notion, Airtable, Mailchimp | Notion, Airtable y Mailchimp |
| Webhook (salida), Slack, Discord, Telegram | Webhooks y avisos |
| Código en el servidor y APIs bloqueadas en el navegador | Funciones de backend |
Las tarjetas de Analytics (Meta Pixel, Google Analytics, Google Tag Manager, Microsoft Clarity, Hotjar), de Chat y la de Consentimiento de cookies piden solo un ID, y la descripción de la propia tarjeta dice dónde encontrarlo.
Problemas comunes
- La tarjeta está en verde y no pasa nada. Mira en qué grupo está en la lista de arriba: en las tarjetas que solo guardan, Conectada no prueba que la clave sea correcta. Haz un envío real y lee el error;
- Guardé una pasarela y la otra desapareció. Stripe, Mercado Pago y Pagar.me comparten el mismo lugar: solo una queda activa por app, y guardar otra reemplaza la anterior. Las claves de la pasarela anterior no pasan a la nueva: completa los campos de la nueva pasarela;
- La tarjeta abre la pantalla de planes. La cuenta está en Free o en Starter y esa tarjeta requiere Builder. Mira la tabla de la sección Plan de arriba.