Protege tus automatizaciones de WhatsApp: claves, webhooks y firmas
Una automatización de WhatsApp se protege en cuatro puntos: la clave de IA, guardada cifrada y usada solo para las respuestas de IA; el webhook al que llama una automatización, que debe comprobar una firma HMAC antes de confiar en una petición; el reenvío de los mensajes entrantes, firmado con un secreto que puedes rotar; y las personas y asistentes con acceso, limitados a lo que necesitan.
easyCoexistence guarda tus claves de IA cifradas y nunca vuelve a mostrarlas, firma cada petición de Llamar a mi webhook y cada mensaje reenviado con X-EC-Signature usando un secreto que solo tú tienes, y rechaza las direcciones de webhook que no sean HTTPS públicas.
Cifrado en reposo para las claves de IA guardadas, los secretos de firma y el token de acceso de Meta del número.
Lo único que vuelves a ver de una clave de IA guardada: "terminada en" seguido de sus últimos cuatro caracteres.
Aleatoriedad de cada secreto de firma: whsec_ seguido de 24 bytes aleatorios, uno por automatización y uno por número con reenvío.
Las URL de webhook y de reenvío deben ser HTTPS públicas; las direcciones privadas e internas se rechazan al guardar y antes de cada envío.
Límite sugerido para la antigüedad del valor t de la firma, para rechazar peticiones repetidas.
¿Qué hay que proteger al configurar automatizaciones de WhatsApp?
Cinco credenciales, cada una con su propio lugar y su propia solución si se filtra. Dos pertenecen a las propias automatizaciones: la clave de IA y el secreto de firma de Llamar a mi webhook; el secreto de reenvío pertenece al número; el token de acceso y el inicio de sesión de tu asistente pertenecen a la cuenta. Saber cuál es cuál te indica qué rotar si algo falla.
¿Cómo se guardan y se usan las claves de IA?
Solo desde el panel: el botón AI keys de la página Automatizaciones y, después, Probar y guardar. Primero, la clave se comprueba contra un endpoint gratuito del proveedor, que no consume tokens, y si el proveedor la rechaza se descarta sin guardarse. Una clave válida se cifra en reposo con AES-256-GCM, se descifra solo para llamar a ese proveedor en tus pasos de IA y agentes, y para transcribir mensajes de voz con una clave de OpenAI u OpenRouter, y, a partir de entonces, solo se muestra como "terminada en 1234". Ninguna herramienta MCP acepta ni devuelve una clave, así que nunca pasa por una conversación con tu asistente.
Cada cuenta tiene una clave por proveedor, y guardar una nueva sustituye a la anterior. Crea en el proveedor una clave exclusiva para las automatizaciones, con un límite de gasto si el proveedor lo permite, para poder revocarla sin afectar a tus otras aplicaciones. Si en algún momento el proveedor la rechaza, las automatizaciones que la usan pasan a mostrar En pausa y recibes un único correo; al guardar una clave que funcione, se reactivan solas.
¿Cómo verificar que una petición de Llamar a mi webhook es auténtica?
Comprueba la firma antes de leer cualquier otra cosa. Cada petición incluye X-EC-Signature: t=<segundos unix>,v1=<HMAC-SHA256 en hexadecimal de "<t>.<cuerpo sin procesar>">, calculado con el secreto de firma de esa automatización como clave, que copias del paso en el editor después de guardar. Recalcula el HMAC sobre los bytes sin procesar, compara en tiempo constante y rechaza un t que se aleje más de 5 minutos de tu reloj. El cuerpo también te indica dos cosas que conviene tener en cuenta. dry_run vale true cuando la petición viene de Pruébalo, así que omite todo lo irreversible, como crear un pedido. Y run_id es único en cada ejecución, así que guarda los que ya procesaste y rechaza cualquier petición repetida. Responde en menos de 20 segundos; {"reply": "..."} se envía al cliente tal cual, así que nunca pases texto del cliente sin revisarlo.
POST /hooks/whatsapp HTTP/1.1
Content-Type: application/json
User-Agent: easyCoexistence-automations/1
X-EC-Event: automation.step
X-EC-Signature: t=1794405732,v1=<64 hex characters>
{
"event": "automation.step",
"dry_run": false,
"automation": { "id": "a7d0c3e2-5b1f-4c8e-9a6d-2f4e8b1c7d90", "name": "Order status" },
"run_id": "e41b9f07-3c2a-4d6e-8f15-7a9c0b2d4e68",
"channel": { "type": "whatsapp", "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
"message": { "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==", "type": "text", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.000Z" },
"history": [
{ "direction": "in", "text": "Hi!", "at": "2026-11-11T14:01:40.120Z" },
{ "direction": "in", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.310Z" }
]
}
// Your answer, within 20 seconds (or {} to send nothing):
{ "reply": "Your order #1042 left the shop at 2:20 p.m." }¿Cómo funcionan los secretos de reenvío y cómo se rotan?
Un número configurado como Through easyCoexistence puede reenviar sus mensajes entrantes a tu propio sistema. La primera vez que guardas una URL de reenvío, se genera un secreto que se muestra una sola vez, bajo "Tu secreto de firma, se muestra una vez. Cópialo ahora:"; con él se firma cada POST reenviado, con el mismo esquema X-EC-Signature. El botón Nuevo secreto de la página del número, o set_inbound_mode con rotate_secret en true, genera uno de reemplazo, que también se muestra una sola vez y que a partir de ese momento lo firma todo, incluidos los reintentos de entregas anteriores. También puedes escribir un secreto propio, de al menos 24 caracteres, que se almacena y no se vuelve a mostrar. Dejar de reenviar elimina el secreto, así que si más adelante guardas una URL, se empieza con uno nuevo.
Rota el secreto cuando se vaya alguien del equipo con acceso, cuando un secreto acabe en un repositorio, un ticket o un registro, y cuando cambies de alojamiento. El secreto de Llamar a mi webhook pertenece a la automatización y solo lo ve el propietario de la cuenta. Donde el editor muestra Nuevo secreto, bajo un disparador "Tu sistema llama a una URL", ese botón lo sustituye y el anterior deja de funcionar al instante; en una automatización sin ese botón, crea de nuevo la automatización, configura tu receptor con el nuevo secreto y luego elimina la automatización anterior.
¿A qué direcciones pueden llamar las automatizaciones?
Solo a direcciones HTTPS públicas. Una URL de Llamar a mi webhook o una URL de reenvío que empiece por http://, apunte a localhost, a un rango de red privada, a un nombre .internal o .local, o a una dirección de metadatos de la nube se rechaza al guardarla, y se vuelve a comprobar tras resolver el DNS antes de cada petición, de modo que un nombre público no pueda apuntarse más tarde hacia una red privada. No se siguen redirecciones: un 301 o un 302 hace fallar el paso, así que guarda la dirección final.
No pongas secretos en la propia URL. list_automations devuelve los pasos de cada automatización, URL del webhook incluida, a cualquier asistente conectado a tu cuenta, así que un token en la cadena de consulta queda visible ahí. Deja que sea la firma la que aporte la prueba.
¿Cómo mantener el acceso al mínimo?
Da a cada persona y a cada herramienta solo el acceso que su trabajo requiere, y retira lo que ya no se usa. La parte del conector, con el inicio de sesión, las confirmaciones y las herramientas bloqueadas, se explica en la página sobre cómo conectar WhatsApp a una IA de forma segura; en cuanto a las automatizaciones, estos son los hábitos que más importan:
- Pide
get_api_credentialssolo en un chat privado: el token de acceso del número queda luego en esa transcripción. - Usa Llamar a mi webhook o una URL de reenvío en lugar de entregar el token a una herramienta de terceros.
- Elimina las automatizaciones que ya no uses; así también quedan anulados sus secretos de firma.
- Recuerda que los registros de ejecución guardan los mensajes de los clientes y las respuestas durante 30 días, y que las Conversaciones guardan los chats durante tu período de retención (30, 90 o 365 días), y ambos pueden leerse en el panel y a través de tu asistente conectado.
- En un número configurado como Directo a tu sistema, pon un secreto largo y aleatorio en la ruta de la URL de callback, ya que ahí no se puede comprobar la firma de Meta.
Errores comunes
- Verificar la firma sobre un JSON que tu framework ha vuelto a serializar. Muchos parsers cambian los espacios, los escapes o el orden de las claves; calcula el HMAC sobre los bytes sin procesar de la petición, siempre que tu stack te dé acceso a ellos.
- Ejecutar efectos secundarios en las llamadas de prueba. Pruébalo llama a tu webhook con dry_run en true; un pedido, un reembolso o un registro en el CRM creado en ese momento es real.
- Pegar una clave de IA en un chat con tu asistente para ahorrar tiempo. Ninguna herramienta la acepta y queda en la transcripción; usa AI keys en el panel.
- Verificar un reenvío con el secreto de Llamar a mi webhook, o al revés. Son secretos distintos: uno por número para los reenvíos y uno por automatización para las llamadas a webhooks.
Tu número sigue en la Cloud API oficial de Meta mediante Coexistencia, monitoreado 24/7. Desde US$ 9 hasta US$ 0.75 por número al mes: el precio baja a medida que añades números, y los primeros 3 días son gratis.
Preguntas frecuentes
¿El personal o el soporte de easyCoexistence puede ver mi clave de IA?
La clave nunca se muestra después de guardarla: ni en el panel, ni en los resultados de MCP, ni en la información que consulta el asistente de soporte. Solo la descifra el sistema, en el momento en que llama a tu proveedor para generar una respuesta de IA.
¿Quién puede leer los registros de ejecución de mis automatizaciones?
Cualquier persona que haya iniciado sesión en tu cuenta de easyCoexistence, incluidas las personas que invitaste, en la pestaña Runs, y cualquier asistente conectado a la cuenta, mediante list_automation_runs y get_automation_run. Los registros incluyen el mensaje del cliente y la respuesta, y se eliminan pasados 30 días.
¿Cómo elimino una clave de IA de forma segura?
Primero desactiva las automatizaciones que la usan, y cualquier agente que funcione con ella, luego selecciona Quitar en AI keys y revoca la clave en el proveedor. Si la quitas mientras alguna automatización todavía la usa, esta se pone en pausa en su siguiente respuesta de IA y recibes un correo.
¿La función Probar envía datos de clientes a mi webhook?
Solo envía el texto de ejemplo que escribiste, con dry_run en true y un historial vacío. Las ejecuciones reales envían el mensaje entrante y los mensajes recientes del chat, hasta 10, así que trata tu endpoint como un sistema que maneja datos de clientes.
Sigue leyendo
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratisVerificado el