Conectar una aplicación
Todas las aplicaciones nativas se conectan con el mismo asistente de tres pasos: Configurar → Probar conexión → Habilitar herramientas. Lo único que cambia entre apps son los campos de credenciales del primer paso.
Para empezar, entra a Aplicaciones, abre la app que quieras y haz clic en "Conectar [nombre de la app]".
Cada cuenta que conectas es una instalación independiente. Puedes repetir este proceso para conectar varias cuentas de la misma app (por ejemplo, dos tiendas Shopify) y exponer herramientas distintas en cada una.
Paso 1: Configurar
Define la identidad de la instalación y sus credenciales.
| Campo | Descripción |
|---|---|
| Nombre interno (obligatorio) | Solo se ve dentro del workspace. Úsalo para distinguir instalaciones: "Tienda CDMX", "Cuenta MTY"… |
| Descripción | Notas opcionales sobre esta instalación. |
| Credenciales y configuración | Los campos específicos de cada app (ver abajo). |
Cuando termines, haz clic en "Crear y continuar".
Credenciales por aplicación
Cada app pide datos distintos en la sección "Credenciales y configuración". Algunos ejemplos:
- Platica — Tu API key de Platica (
pl_key_…) y el Channel ID del canal de WhatsApp asociado. - OpenTable — El país y la ciudad por defecto donde buscar restaurantes (o el código de estado mexicano, 01-32, como alternativa). Opcionalmente puedes fijar un restaurante concreto con su slug (el de la URL pública
opentable.com.mx/r/…), su ID numérico o un nombre de búsqueda por defecto; si defines el slug, las consultas van directo a ese restaurante. - Shopify — La URL de tu tienda (
https://tu-tienda.myshopify.com), un Admin API access token (shpat_…) con permiso de lectura sobre productos y, opcionalmente, la URL pública de tu storefront (sin.myshopify.com). - Documents e Intérprete de código — Funcionan dentro de Platica, así que su configuración es mínima.
Paso 2: Probar conexión
Platica valida que las credenciales funcionen haciendo una llamada de prueba al servicio. Si la prueba falla, vuelve al paso anterior y revisa los datos (una API key incompleta o un ID equivocado son las causas más comunes).
Con la conexión verificada, continúa al último paso.
Paso 3: Habilitar herramientas
Elige cuáles herramientas de la app se expondrán a tu agente. Cada herramienta aparece con su nombre técnico y una descripción de lo que hace; solo las marcadas estarán disponibles.
Por ejemplo, la app Platica ofrece tres herramientas:
| Herramienta | Qué hace |
|---|---|
platica_send_template | Envía una plantilla de WhatsApp aprobada al cliente de la conversación actual (recordatorios, confirmaciones, promociones…). |
platica_list_templates | Lista todas las plantillas de WhatsApp disponibles, con sus nombres exactos, parámetros y estado de aprobación. |
platica_update_client | Actualiza la información del cliente de la conversación actual, identificado automáticamente por su número de teléfono. |
Haz clic en "Guardar y terminar" y la instalación quedará lista.
Conectar la aplicación deja las herramientas disponibles a nivel workspace, pero no las activa solas. Cada agente activa las herramientas que quiere usar desde su propia pestaña "Herramientas".
Marca únicamente las herramientas que tu operación necesita. Mientras menos herramientas expongas, más fácil le resulta al agente elegir la correcta en el momento adecuado.