Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Perfil de la API de Messenger: saludo, botón Get Started, ice breakers y menú persistente

El perfil de Messenger de una Página de Facebook se configura en /{page-id}/messenger_profile con un token de acceso de la Página y pages_messaging: POST escribe propiedades como get_started, greeting, ice_breakers, persistent_menu y commands, GET las lee con fields, y DELETE elimina las indicadas en un array fields. Meta permite 10 llamadas cada 10 minutos por Página, y solo se sobrescriben las propiedades enviadas.

easyCoexistence responde a las conversaciones de Messenger de una Página con send_social_dm dentro de la ventana de 24 horas, desde Claude, ChatGPT o tu propio código, con los nuevos mensajes reenviados a tu endpoint conforme llegan.

10 per 10 min

Llamadas a la API de perfil de Messenger permitidas por Página en cada intervalo de 10 minutos.

4 questions

Máximo de ice breakers que configura la API; cuando ambos están definidos, los de la API tienen prioridad sobre el botón Get Started.

20 items

Máximo de elementos de nivel superior en un menú persistente; el título de cada elemento está limitado a 30 caracteres.

24 hours

Tiempo máximo que puede tardar una actualización del menú persistente a nivel de Página; un menú configurado para una persona se actualiza en tiempo real.

Deprecated

Texto del saludo, que la referencia de saludo de Meta indica que ya no funciona en Messenger para Android e iOS.

¿Qué contiene el perfil de Messenger?

La configuración de la que parte la experiencia de Messenger de una Página. La API de perfil de Messenger de Meta enumera estas propiedades, cada una configurada y leída en el mismo endpoint; en una app en Modo de desarrollo, la configuración solo es visible para las personas con un rol en la app:

get_startedThe payload sent as a messaging_postbacks event when someone taps Get Started
greetingLocale-specific welcome screen text, which Meta marks deprecated as of November 2026
ice_breakersUp to 4 questions a person can tap to start the conversation
persistent_menuUp to 20 buttons kept in the conversation, per locale
commandsKeywords a person can tap or type, each with a description
whitelisted_domainsUp to 50 HTTPS domains for the Messenger Extensions SDK and the checkbox plugin
account_linking_urlThe HTTPS callback for linking a person's account with the business
subject_to_new_eu_privacy_rulesRead-only flag for Pages affected by Meta's Messenger API updates for Europe

¿Cómo se leen, configuran y eliminan las propiedades?

Con tres métodos en un mismo endpoint, llamados con el token de la Página. POST recibe un cuerpo JSON de propiedades y sobrescribe solo las que nombra, GET recibe fields como lista separada por comas, y DELETE recibe un cuerpo JSON cuyo array fields indica qué eliminar; POST y DELETE responden con result success. Configurar un botón Get Started y un menú en una sola llamada:

Get Started and a persistent menu in one POST
POST /{page-id}/messenger_profile
{
  "get_started": { "payload": "GET_STARTED" },
  "persistent_menu": [
    {
      "locale": "default",
      "composer_input_disabled": false,
      "call_to_actions": [
        { "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
        { "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
      ]
    }
  ]
}

{ "result": "success" }

¿Cómo funciona el botón Get Started?

Aparece en la pantalla de bienvenida, que muestra el nombre de la Página, su foto de perfil y su foto de portada, y el tiempo que el negocio suele tardar en responder. Al tocarlo, se publica Get Started en la conversación, se envía get_started.payload a la app como evento messaging_postbacks y se abre la ventana de mensajería estándar. Meta indica que el botón no es compatible cuando Messenger se ejecuta en el navegador integrado de la app de Facebook, y un menú persistente requiere que antes esté configurado.

¿El texto del saludo sigue funcionando?

No en los teléfonos. La referencia de Meta ahora se titula [Deprecated] Greeting Text: la función ya no funciona en Messenger para Android e iOS, y aunque la API puede seguir aceptando la propiedad greeting, los clientes no la verán, por lo que Meta pide a los desarrolladores que la eviten. Según la documentación, greeting contiene un texto por idioma, con default obligatorio, de hasta 160 caracteres, personalizable con {{user_first_name}}, {{user_last_name}} o {{user_full_name}}, y configurarlo requiere el rol de Administrador en la Página.

¿Cómo funcionan los ice breakers?

Son una lista de hasta 4 preguntas que la persona puede tocar para iniciar una conversación; la pregunta se publica en el hilo como si la persona la hubiera hecho, y su payload vuelve como evento postback. Desde abril de 2022 están localizados: cada objeto de ice_breakers contiene call_to_actions y un locale, es obligatorio un locale por defecto, y un DELETE de ice_breakers elimina todos. Meta ordena los elementos que compiten por una nueva conversación:

  • Los ice breakers de la API tienen prioridad sobre el botón Get Started cuando ambos están configurados.
  • Ambos van antes que las preguntas personalizadas configuradas en la bandeja de entrada de la Página, cuya edición está deshabilitada mientras haya ice breakers de la API configurados.

¿Cómo se construye el menú persistente?

Como un array de menús, uno por idioma con default obligatorio, cada uno con hasta 20 call_to_actions de tipo web_url o postback. Un título admite hasta 30 caracteres y un payload de postback hasta 1,000, y si composer_input_disabled se define como true, el menú, los botones y las webviews son la única forma de interactuar. Requisitos de Meta antes de que aparezca:

  • Un botón Get Started ya configurado y el permiso pages_messaging.
  • Una Página publicada, y la app configurada como pública.
  • El rol de Administrador en la Página para quien lo configure.
  • Messenger v106 o posterior en iOS o Android, fuera del navegador integrado de la app de Facebook.
  • Los cambios a nivel de Página pueden tardar hasta 24 horas; un menú para una persona, configurado mediante custom_user_settings con un PSID, se actualiza en tiempo real.

¿Qué son los comandos?

Palabras clave que la persona puede invocar en cualquier momento, desde un menú de comandos junto al campo de redacción, escribiendo una barra o una arroba, o desde un recuadro emergente cuando escribe una palabra coincidente. Cada idioma admite de 1 a 100 comandos, con un nombre de 1 a 32 caracteres sin barra inicial y una descripción de 1 a 64; cuando hay comandos configurados, tienen prioridad sobre el menú persistente. Los comandos invocados llegan a la app dentro del evento messages, en message.commands.

¿Qué hacen whitelisted_domains y account_linking_url?

Ambos atienden experiencias fuera de la propia conversación. whitelisted_domains enumera hasta 50 dominios que la webview de Messenger puede abrir para el SDK de Messenger Extensions y el plugin de casilla de verificación, cada uno servido por HTTPS con un nombre totalmente cualificado, nunca una dirección IP ni localhost, y configurarlo requiere el rol de Administrador en la Página. account_linking_url es el callback HTTPS que vincula la cuenta de Messenger de una persona con su cuenta en el negocio.

¿Cómo configura easyCoexistence el perfil de Messenger de una Página?

No lo hace: ninguna herramienta llama a {page-id}/messenger_profile, y los tokens de Página no se entregan, así que configurar el perfil queda fuera de esta conexión. Los comandos que invoca la gente llegan en el evento messages que easyCoexistence reenvía y que leen las automatizaciones; los toques que Meta informa como eventos messaging_postbacks, desde Get Started, elementos de menú de tipo postback y ice breakers, no se reenvían, ya que las Páginas están suscritas a feed, messages y mention.

Errores comunes

  • Configurar un menú persistente antes que Get Started. Los requisitos de Meta incluyen un botón Get Started, así que configure primero get_started.
  • Omitir el idioma por defecto. Los ice breakers, los menús y los comandos necesitan cada uno un objeto con locale igual a default como respaldo.
  • Llamar a la API de perfil en un bucle. Meta permite 10 llamadas cada 10 minutos por Página, así que agrupe varias propiedades en un solo POST.
  • Esperar que un cambio de menú sea inmediato. Una actualización del menú a nivel de Página puede tardar hasta 24 horas en llegar a las personas.
Hacerlo con EasyCoexistence

Configurar el perfil de Messenger no está entre sus herramientas. De US$ 9 a US$ 0.75 por conexión al mes, con una tarifa que baja a medida que añades conexiones, y los primeros 3 días gratis.

Preguntas frecuentes

¿Un menú persistente puede ser distinto para cada persona?

Sí. custom_user_settings con el PSID de la persona sustituye el menú de la Página para esa persona, se actualiza en tiempo real y permite 10 llamadas por persona cada 10 minutos.

¿Qué idiomas admite el perfil de Messenger?

Los que aparecen en la lista de idiomas admitidos por Meta, como en_GB, pt_BR o ja_JP, además de default, el respaldo que se usa cuando ningún idioma coincide con el de la persona.

¿Quién puede cambiar el perfil de Messenger de una Página?

Una app con un token de Página que incluya pages_messaging. El menú persistente, el saludo y la lista de dominios también requieren el rol de Administrador en la Página.

¿Cuánto cuesta easyCoexistence para una Página de Facebook?

Cada Página es una conexión: de US$ 9 a US$ 0.75 por conexión al mes, con un precio que baja a medida que aumenta el número de conexiones, y los primeros 3 días son 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