Webhooks de redes sociales: comentarios, menciones y mensajes a un solo endpoint
easyCoexistence reenvía los eventos de redes sociales a tu propio endpoint HTTPS en cuanto ocurren: comentarios, menciones y DM de Instagram y Facebook, y comentarios de TikTok. Cada uno llega en un sobre, con el evento original de la red dentro sin cambios, firmado por cuenta con X-EC-Signature. Actívalo por cuenta con set_social_webhook_destination desde Claude o ChatGPT, o con la Partner API. Los mensajes de un número de WhatsApp también llegan a tu servidor.
- Comentarios, menciones y DM en cuanto ocurren
- Un sobre, firmado por cada cuenta
- Se configura desde Claude, ChatGPT o la Partner API
No se cobra nada durante 3 días. Cancela cuando quieras.
Cuántas veces envía easyCoexistence cada evento social reenviado; no guarda copia, así que nada se vuelve a enviar después.
Con qué rapidez el webhook comment.update de TikTok informa de un comentario creado, eliminado o que cambia de visibilidad en los videos públicos de una cuenta propia.
Dónde reciben las apps de Instagram Login las @menciones: dentro de la notificación del webhook de comentarios, no como un campo propio.
Lo que informan las notificaciones push de YouTube sobre un canal: una nueva subida, un nuevo título o una nueva descripción.
Cuánto tiempo sigue Meta reintentando un webhook de WhatsApp que tu servidor no aceptó, lo que puede generar duplicados.
¿Qué eventos envía cada red?
Instagram, Facebook y TikTok envían eventos a easyCoexistence, que pasa cada uno a la URL que configures para esa cuenta. Instagram envía los comentarios nuevos, con las @menciones llegando dentro de la notificación de comentarios, y los DM. Una página de Facebook envía la actividad del feed, que incluye los comentarios nuevos, además de los mensajes de Messenger y las menciones de la página. TikTok envía comment.update, que se dispara cuando se crea un comentario, se elimina o cambia de visibilidad.
YouTube y LinkedIn no envían a easyCoexistence eventos de comentarios ni de mensajes, así que un agente lee sus comentarios bajo petición. Un número de WhatsApp funciona por su propia vía: Meta entrega sus mensajes directamente a tu servidor, o easyCoexistence los reenvía firmados cuando el número funciona en modo gestionado.
| What arrives | Sent by | |
|---|---|---|
| Comments, mentions and DMs | easyCoexistence, signed per account | |
| Feed activity, Messenger and mentions | easyCoexistence, signed per account | |
| TikTok | comment.update events | easyCoexistence, signed per account |
| Messages and echoes from the app | Meta directly, or easyCoexistence in managed mode | |
| YouTube | No comment events | Read with list_youtube_comments |
| No comment events | Read with list_linkedin_comments |
¿Cómo es un evento reenviado?
El mismo sobre JSON en cada red, enviado con Content-Type application/json: platform, la red; account_id, el ID que usan las herramientas MCP y la Partner API; external_id, el ID de la cuenta en la red; y entry, el evento propio de la red tal como llegó. En Instagram y Facebook, entry es la entrada del webhook de Meta, con changes para comentarios y menciones y messaging para los DM. En TikTok contiene el evento comment.update, con comment_id, video_id y parent_comment_id como cadenas, para que los IDs de 64 bits no se redondeen. Un mensaje de Messenger llega así:
{
"platform": "facebook",
"account_id": "<ACCOUNT_ID>",
"external_id": "<PAGE_ID>",
"entry": {
"id": "<PAGE_ID>",
"time": 1793318400512,
"messaging": [
{
"sender": { "id": "<PAGE_SCOPED_ID>" },
"recipient": { "id": "<PAGE_ID>" },
"timestamp": 1793318399870,
"message": { "mid": "<MESSAGE_ID>", "text": "Are you open on Sunday?" }
}
]
}
}¿Cómo verifico X-EC-Signature?
Con el secreto de firma que se devuelve al configurar el destino, único para esa cuenta y mostrado una sola vez. El encabezado tiene la forma t=<unix>,v1=<hex>, y v1 es un HMAC-SHA256 de la marca de tiempo, un punto y el cuerpo sin procesar de la petición, firmado con ese secreto. Lee el cuerpo como bytes antes de analizarlo, rechaza una marca de tiempo con más de 5 minutos de diferencia con tu reloj, busca el secreto por el account_id del evento y compara los dos digests en tiempo constante. Después responde 2xx y encola el trabajo. En PHP, son unas pocas líneas:
<?php
// POST /hooks/social: one endpoint for the events of each account
$raw = file_get_contents('php://input'); // the exact bytes that were signed
parse_str(str_replace(',', '&', $_SERVER['HTTP_X_EC_SIGNATURE'] ?? ''), $sig);
$event = json_decode($raw, true); // platform, account_id, external_id, entry
$secret = secret_for($event['account_id'] ?? ''); // the signing_secret stored for that account
$fresh = ctype_digit($sig['t'] ?? '') && abs(time() - (int) $sig['t']) <= 300;
$expected = hash_hmac('sha256', ($sig['t'] ?? '') . '.' . $raw, (string) $secret);
if (!$secret || !$fresh || !hash_equals($expected, $sig['v1'] ?? '')) {
http_response_code(401);
exit;
}
http_response_code(204);
enqueue($event); // keep this quick: the forward waits 8 seconds and is never resent¿Cómo activo el reenvío para una cuenta?
Desde un asistente o desde tu backend. Pide a Claude o ChatGPT que ejecute set_social_webhook_destination con la cuenta y tu URL HTTPS, o llama a PUT /api/v1/channels/:id/webhook en la Partner API con tu clave ec_live_ y un cuerpo que contenga la url. Ambos devuelven el signing_secret de la cuenta una sola vez, así que guárdalo asociado al account_id en ese momento. Si vuelves a llamar a cualquiera de los dos, se emite un secreto nuevo, y una url en null desactiva el reenvío.
La URL debe ser HTTPS en un host público: una dirección privada se rechaza al configurarla y de nuevo al entregar. Un solo endpoint puede atender a muchas cuentas, ya que cada evento indica su account_id. Para un número de WhatsApp, set_webhook_destination envía las entregas de Meta hacia ti, y set_inbound_mode con un forward_url las reenvía firmadas.
¿Qué pasa cuando tu endpoint está lento o caído?
El evento no se vuelve a enviar. easyCoexistence hace un solo intento, espera hasta 8 segundos una respuesta, no sigue redirecciones y no guarda copia, porque reintentar implicaría almacenar los comentarios y mensajes de tus clientes. Responde 2xx en cuanto la firma sea válida, haz el trabajo lento desde una cola y deduplica con los IDs propios de la red, como un ID de comentario o un mid de mensaje, por si un evento llega dos veces.
WhatsApp es distinto. En modo directo, Meta reintenta una entrega que tu servidor no aceptó durante hasta 7 días. En modo gestionado, easyCoexistence pone los mensajes en cola para tu forward_url y reintenta con backoff. Los eventos de estado de Partner, como una conexión que se cae, se reintentan durante unas 33 horas.
¿Cómo llegan a un agente los comentarios de YouTube y LinkedIn?
Leyéndolos según un calendario. Las notificaciones push de YouTube informan de una nueva subida, un nuevo título o una nueva descripción, no de comentarios, y easyCoexistence no recibe eventos de comentarios de LinkedIn, así que ninguno de los dos reenvía nada. Un agente consulta en su lugar: list_youtube_comments devuelve los hilos de un video o los de todo el canal, incluidos los retenidos para revisión, y list_linkedin_comments devuelve los comentarios de una publicación o las respuestas a uno de ellos. En n8n, Make o Zapier, un disparador programado inicia la consulta; en tu propio código, un trabajo cron obtiene las credenciales del canal y llama directamente al endpoint commentThreads de YouTube o al endpoint de comentarios de LinkedIn.
Cómo configurarlo
- Set the destinationRun set_social_webhook_destination with the account and an HTTPS URL, or call PUT /api/v1/channels/:id/webhook with your ec_live_ key.
- Store the secretSave the signing_secret from the response against that account_id, since it is shown only once.
- Verify each deliveryCheck that the timestamp is fresh and that v1 matches an HMAC-SHA256 of the timestamp, a dot and the raw body.
- Acknowledge, then workAnswer 2xx straight away and hand the event to a queue, because easyCoexistence sends it only once.
Errores comunes
- Comprobar el HMAC sobre el JSON ya analizado. La firma cubre el cuerpo sin procesar byte a byte, y volver a serializar el objeto analizado cambia esos bytes, así que verifica antes de analizar.
- Usar un solo secreto para todas las cuentas. Cada cuenta firma con su propio secreto, así que búscalo por el account_id del evento antes de comparar v1.
- Volver a configurar el destino sin actualizar tu endpoint. Cada llamada emite un secreto nuevo y el anterior deja de firmar de inmediato, así que guarda el nuevo enseguida.
- Indicar una URL que redirige. Los reenvíos no siguen redirecciones, así que un cambio de ruta o de host pierde el evento; configura la dirección final.
easyCoexistence envía los comentarios, menciones y DM de Instagram y Facebook, y los comentarios de TikTok, a tu endpoint en cuanto ocurren, firmados por cuenta, y dirige los mensajes de WhatsApp a tu servidor, para que tus agentes de IA reciban los mensajes de los clientes a través de la API oficial de cada red, con cada conexión supervisada 24/7. De US$ 9 a US$ 0.75 por conexión al mes, que baja a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Cómo llegan a mi endpoint los mensajes de un número de WhatsApp?
De una de dos maneras. set_webhook_destination hace que Meta los entregue directamente a tu servidor, mientras que set_inbound_mode con un forward_url hace que easyCoexistence los reenvíe firmados con X-EC-Signature, reintentando con backoff.
¿Puede llegar el mismo evento dos veces?
Sí, así que deduplica con los IDs propios de la red, como un ID de comentario o un mid de mensaje. Los reintentos de Meta de una entrega de WhatsApp que tu servidor no aceptó, durante hasta 7 días, también pueden generar duplicados.
¿Puede un solo endpoint recibir eventos de varias cuentas?
Sí. Cada evento incluye platform y account_id, así que una sola URL puede atender a muchas cuentas, siempre que compruebe cada firma con el secreto propio de esa cuenta.
¿Cuánto cuesta easyCoexistence para los webhooks de redes sociales?
De US$ 9 a US$ 0.75 por conexión al mes, que baja a medida que añades conexiones y es el mismo en cada red. El reenvío, el servidor MCP y la Partner API están incluidos, con los primeros 3 días gratis.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el