Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

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
Empezar prueba gratis

No se cobra nada durante 3 días. Cancela cuando quieras.

Solo APIs oficialesMCP para Claude y ChatGPTCada conexión monitorizada 24/73 días gratis
1 attempt

Cuántas veces envía easyCoexistence cada evento social reenviado; no guarda copia, así que nada se vuelve a enviar después.

Within 5 minutes

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.

In comments

Dónde reciben las apps de Instagram Login las @menciones: dentro de la notificación del webhook de comentarios, no como un campo propio.

3 events

Lo que informan las notificaciones push de YouTube sobre un canal: una nueva subida, un nuevo título o una nueva descripción.

7 days

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 arrivesSent by
InstagramComments, mentions and DMseasyCoexistence, signed per account
FacebookFeed activity, Messenger and mentionseasyCoexistence, signed per account
TikTokcomment.update eventseasyCoexistence, signed per account
WhatsAppMessages and echoes from the appMeta directly, or easyCoexistence in managed mode
YouTubeNo comment eventsRead with list_youtube_comments
LinkedInNo comment eventsRead 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í:

A forwarded Messenger message, trimmed
{
  "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: verifying a forwarded event
<?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

  1. 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.
  2. Store the secretSave the signing_secret from the response against that account_id, since it is shown only once.
  3. Verify each deliveryCheck that the timestamp is fresh and that v1 matches an HMAC-SHA256 of the timestamp, a dot and the raw body.
  4. 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.
Hacerlo con EasyCoexistence

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