Cómo generar y administrar API keys para integraciones externas
En esta página
Plan requerido
Disponible desde el Plan Pro. Los planes Básico y Plus no incluyen la sección de Integraciones.
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
- Permiso de Configuración en tu equipo
- 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 la lista de keys creadas, con su nombre y un valor enmascarado (tmd_••••••••••••••••). Para eliminar una key, haz clic en el ícono de bote de basura junto a ella. Esta acción aplica de inmediato: cualquier integración que la use dejará de funcionar.
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.
¿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?