Cómo generar y administrar API keys del CRM de WhatsApp
En esta página
Plan requerido
Disponible desde el Plan Pro. En los planes Básico y Plus la tarjeta API Keys de Integraciones se ve, pero no deja crear llaves.
Las API keys de TMD permiten que un sistema externo envíe mensajes de WhatsApp a tus clientes a través del CRM de tu negocio, sin pasar por el panel de TMD. Son útiles si tienes una automatización, un ERP o un desarrollo propio que necesita notificar a tus clientes automáticamente.
Requisitos
- Cuenta con Plan Pro
- Un rol con permiso de gestionar Clientes (el Propietario y el Gerente lo tienen de fábrica)
- Acceso a Todas las sucursales: las llaves son de toda la organización, así que quien sólo ve algunas sucursales no las ve ni las crea
- CRM de WhatsApp conectado y activo en tu organización
Qué puedes hacer con una API key
Cada API key autentica solicitudes al endpoint de envío de mensajes de WhatsApp de tu CRM. No da acceso a órdenes, menú, clientes ni ningún otro dato de tu cuenta — su único propósito es permitir que un sistema externo envíe mensajes de WhatsApp a nombre de tu negocio a través de TMD.
Pasos para crear una API key
- Ve a Ajustes → Integraciones.
- En la tarjeta API Keys, haz clic en "Nueva API key".
- Escribe un nombre que identifique para qué la vas a usar (por ejemplo, "Automatización pedidos ERP") en el campo Nombre.
- Haz clic en "Crear".
- Copia la key que aparece: TMD te avisa "Guarda esta key ahora. No podrás verla de nuevo."
- Haz clic en "Listo" para cerrar el modal.
Advertencia
La key completa solo se muestra una vez, en el momento en que la creas. Si la pierdes, tendrás que eliminarla y generar una nueva — TMD no puede volver a mostrártela.
Cómo usar la API key
Incluye la key en el encabezado Authorization: Bearer <tu-api-key> de tus solicitudes al endpoint de mensajes de WhatsApp de TMD. Cada key queda ligada a tu organización, así que solo puede enviar mensajes en nombre de tu propio negocio.
Administrar tus API keys
En la tarjeta API Keys verás las keys de toda la organización —no sólo las tuyas—, cada una con su nombre, un valor enmascarado (tmd_••••••••••••••••) y quién la creó (Creada por). Cualquiera con los requisitos de arriba puede eliminar cualquier key: toca el ícono de bote de basura junto a ella. Esta acción aplica de inmediato: cualquier integración que la use dejará de funcionar.
Una key depende de quien la creó
Cada key funciona sólo mientras la persona que la creó siga en tu equipo, con acceso a todas las sucursales y con permiso de gestionar clientes:
- Si la quitas del equipo, o le limitas el acceso a sólo algunas sucursales, sus keys se borran.
- Si le cambias el rol a uno sin permiso de gestionar clientes, sus keys dejan de funcionar.
Por eso conviene que las keys de integraciones importantes las cree el Propietario o alguien que se va a quedar.
Qué pasa después
Una vez creada, la key funciona de inmediato para autenticar solicitudes externas. Si tu equipo de desarrollo necesita integrarla, comparte con ellos solo la key (nunca capturas de pantalla del valor sin enmascarar) junto con el endpoint de mensajes de WhatsApp.
Preguntas frecuentes
¿Puedo usar la API key para leer mis órdenes o menú desde un sistema externo? No. Las API keys de TMD actualmente solo autentican el envío de mensajes de WhatsApp desde tu CRM. No dan acceso a otros datos de tu cuenta.
¿Cuántas API keys puedo crear? No hay un límite fijo en el panel; puedes crear una por cada integración que quieras identificar por separado.
Una integración dejó de funcionar de un día para otro. ¿Qué pasó? Lo más probable es que quien creó la key ya no esté en el equipo, ya no tenga acceso a todas las sucursales o le hayan cambiado el rol. Revisa en la lista quién la creó; si la key ya no aparece, crea una nueva y cámbiala en el sistema externo.
¿Qué pasa si elimino una API key por error? La integración que la usaba dejará de poder enviar mensajes de inmediato. Deberás crear una nueva key y actualizarla en el sistema externo.
¿Te resultó útil este artículo?