Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Webhook de mención en Facebook: cuando alguien menciona tu Página

El campo mention de los webhooks de Página de Facebook avisa a una app cuando alguien @menciona la Página en una publicación o un comentario. Meta envía un change con field igual a mention, cuyo value puede traer el post_id, el comment_id si es un comentario, el texto en message, los enlaces y medios adjuntos, y item y verb, en un POST firmado con X-Hub-Signature-256.

easyCoexistence suscribe cada Página que conectes a mention, junto a feed y messages, y reenvía sus eventos de mención a tu endpoint HTTPS en cuanto llegan, firmados con un secreto de esa Página y sin guardar copia, para que tu agente conozca cada mención en el momento en que ocurre.

mention

Campo de webhook de Página para nuevas menciones de una Página, incluidas las de comentarios y publicaciones.

pages_manage_metadata

Permiso que un administrador de la Página con privilegios MODERATE debe conceder antes de que los webhooks de Página lleguen a la URL de callback de una app.

@ + name

Cómo se menciona una Página en una publicación o comentario: escribir @ y el nombre de la Página, y elegirla.

36 hours

Cuánto tiempo reintenta Meta una notificación de Página fallida, con frecuencia decreciente, antes de descartarla.

tagged_time

Campo que el edge /{page-id}/tagged añade a cada publicación pública en la que la Página ha sido etiquetada.

¿Qué activa el webhook de mención?

Que alguien mencione la Página en una publicación o un comentario. En Facebook, una mención se hace escribiendo @ y el nombre de la Página y eligiéndola entre las sugerencias, y la referencia de Meta describe el campo como nuevas menciones de una Página, incluidas las de comentarios y publicaciones. El Centro de Ayuda de Facebook indica que la configuración de una Página puede impedir que se la mencione.

¿Cómo es una notificación de mención?

Un POST con object igual a page y una entry para la Página mencionada: su ID, una time y un array changes cuyo field es mention. La referencia de Meta enumera los campos del value pero no da ningún ejemplo, así que esta mención en una publicación se construye a partir de esa lista:

A mention in a post, from the fields in Meta's reference
{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1793520000,
      "changes": [
        {
          "field": "mention",
          "value": {
            "item": "post",
            "verb": "add",
            "post_id": "<POST_ID>",
            "message": "<TEXT_WITH_THE_MENTION>"
          }
        }
      ]
    }
  ]
}

¿Qué significa cada campo de una mención?

Estos son los campos del value en la referencia de Meta; cuáles trae una notificación depende de la publicación o el comentario:

  • post_id: el ID de la publicación que mencionó la Página.
  • comment_id: el ID del comentario, cuando la mención está en un comentario; parent_id: el ID de su elemento padre.
  • message: el texto que contiene la mención.
  • link, photo, photos y video: enlaces a lo que la publicación o el comentario tiene adjunto.
  • item y verb: el tipo de objeto y lo que le ocurrió, según las mismas listas que usa el campo feed.
  • created_time: cuándo se creó la publicación o el comentario.
  • from y message_tags: el autor y los perfiles etiquetados en el texto, ambos marcados solo para Workplace.
  • También listados: action, album_id, event_id, photo_id, video_id, share_id, published, reaction_type, recipient_id y open_graph_story_id.

¿Qué permiso necesita el campo mention?

pages_manage_metadata, que Meta exige que conceda un administrador de la Página con privilegios MODERATE antes de que los webhooks de Página lleguen a una app. La Página se suscribe mediante POST /{page-id}/subscribed_apps con mention entre sus subscribed_fields, usando un token de Página de alguien con la tarea CREATE_CONTENT, MANAGE o MODERATE, con pages_manage_metadata y pages_show_list. La app también se suscribe a mention, ya que solo se entregan los campos suscritos en ambos niveles, y las Páginas gestionadas por personas sin un rol en la app necesitan esos permisos en Advanced Access.

¿Cómo se lee la publicación o el comentario que menciona la Página?

Por su ID, con el token de la Página, cuando Meta lo permite. Un token de Página lee las publicaciones publicadas en la Página o por ella; las publicaciones compartidas públicamente de otras Páginas requieren pages_manage_posts y la función Page Public Content Access, con un token de un administrador de la Página; y Meta vincula la lectura de la publicación de una persona al permiso user_posts de esa persona.

Looking up the post or the comment
GET https://graph.facebook.com/<POST_ID>
  ?fields=message,permalink_url,created_time
  &access_token=<PAGE_ACCESS_TOKEN>

GET https://graph.facebook.com/<COMMENT_ID>
  ?fields=message,from,created_time
  &access_token=<PAGE_ACCESS_TOKEN>

¿Dónde más puede una Página encontrar sus menciones?

En el edge tagged. GET /{page-id}/tagged enumera las publicaciones públicas en las que la Página ha sido etiquetada, cada una con un tagged_time, lo que también incluye publicaciones anteriores a la configuración del webhook. Requiere un token de Página de alguien con la tarea CREATE_CONTENT, MANAGE o MODERATE, con pages_read_user_content y pages_show_list, y Meta indica que puede requerirse la función Page Public Content Access. En una publicación de una persona, Meta devuelve from solo a quien la escribió.

¿Cómo entrega easyCoexistence los eventos de mención?

Suscribe cada Página a mention, junto a feed y messages, cuando la Página se conecta. Su app comprueba X-Hub-Signature-256 en cada entrega, responde a Meta de inmediato y envía con POST cada entry de la Página, sin cambios, al endpoint HTTPS que configuras con set_social_webhook_destination o PUT /channels/:id/webhook en la Partner API:

  • X-EC-Signature lleva t=<unix>,v1=<hex>: el HMAC-SHA256 de la marca de tiempo, un punto y el cuerpo sin procesar, firmado con el secreto de firma de la Página.
  • El secreto empieza por whsec_ y se muestra una sola vez; volver a configurar la URL emite uno nuevo, y una URL nula detiene el reenvío.
  • Cada entry se envía una vez, esperando hasta 8 segundos, a una dirección HTTPS que resuelve a una IP pública, sin seguir redirecciones y sin guardar copia.
A forwarded mention, headers included
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793520001,v1=<HEX_HMAC_SHA256>

{
  "platform": "facebook",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<PAGE_ID>",
  "entry": {
    "id": "<PAGE_ID>",
    "time": 1793520000,
    "changes": [
      {
        "field": "mention",
        "value": {
          "item": "post",
          "verb": "add",
          "post_id": "<POST_ID>",
          "message": "<TEXT_WITH_THE_MENTION>"
        }
      }
    ]
  }
}

Errores comunes

  • Leer entry.time como el momento de la mención. Meta lo fija al momento en que se envió la notificación; created_time en el value indica cuándo se creó la publicación o el comentario.
  • Tratar como evento roto una búsqueda que falla. Meta advierte que algunos valores de post_id y comment_id en notificaciones de mención no pueden consultarse, por falta de permiso o por privacidad, así que conserva el texto del mensaje del propio evento.
  • Buscar la publicación antes de responder al reenvío. Los reenvíos no se vuelven a intentar, así que devuelve un 2xx de inmediato y consulta la publicación después.
Hacerlo con EasyCoexistence

De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿El webhook de mención dice quién mencionó la Página?

No para una Página: la referencia de Meta marca from solo para Workplace. Consultar la publicación o el comentario por su ID puede devolver su autor, cuando los permisos de Meta lo permiten.

¿Puedo obtener menciones anteriores a la suscripción de la Página?

No desde el webhook, ya que Meta no guarda un historial de notificaciones que pueda consultarse. El edge tagged enumera las publicaciones públicas en las que la Página ha sido etiquetada.

¿En qué se diferencia el campo mention de feed?

feed informa de cambios en el propio feed de la Página, como publicaciones, comentarios y reacciones allí; mention informa de que la Página ha sido @mencionada en una publicación o un comentario. Cada campo se suscribe por separado.

¿Las reglas de comentarios de easyCoexistence actúan sobre las menciones?

No. Las reglas y automatizaciones actúan sobre los comentarios del campo feed y sobre los mensajes de Messenger; los cambios de mention se reenvían a tu endpoint tal como los envió Meta.

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