Mensajes de marketing

(También conocidos como "notificaciones periódicas")

En este documento, se muestra cómo solicitar permiso a una persona para enviar mensajes de marketing (también conocidos como notificaciones periódicas), cuáles son los requisitos y las limitaciones para enviar solicitudes, y cómo crear y enviar solicitudes de permiso para mensajes de marketing.

Información general

Los mensajes de marketing permiten a una página de Facebook o cuenta profesional de Instagram enviar mensajes fuera del intervalo de mensajes estándar a las personas que te hayan dado permiso para hacerlo. Los mensajes de marketing te permiten entablar relaciones con personas que están interesadas en ti o en tu negocio.

Los mensajes de marketing son una nueva función premium opcional y, en el futuro, tenemos previsto cobrarlos. Por el momento, cobramos a las empresas por enviar mensajes desde la API de WhatsApp Business y tenemos en cuenta los comentarios de los clientes para orientar las decisiones que se tomen en relación con nuestro modelo de precios. Informaremos a los clientes y socios con suficiente antelación acerca de los cambios que se produzcan en relación con la prueba gratuita.

Requisitos

• Debes cumplir todas las Políticas para desarrolladores aplicables cuando uses los mensajes de marketing u otras funciones de la plataforma de Messenger.

• Solo puedes enviar una solicitud para que un usuario se suscriba a los mensajes de marketing dentro del intervalo estándar de envío de mensajes. Cuando un usuario acepta recibir mensajes de marketing, no se abre el intervalo estándar de mensajes.

• Tu app o experiencia de mensajes no debe recibir un volumen excesivo de comentarios negativos de los usuarios. Las funciones de mensajes se pueden restringir o eliminar si determinamos que la experiencia de mensajes de tu app recibió demasiados comentarios negativos por parte de los usuarios.

• No debes utilizar los mensajes de marketing, lo que incluye las solicitudes de suscripción voluntaria, para enviar spam a los usuarios. También se incluye el envío de solicitudes de suscripción voluntaria duplicadas al mismo usuario o a los mismos usuarios con una frecuencia elevada y otros tipos de spam, tal y como se define en nuestras Políticas para desarrolladores.

• Debes respetar las limitaciones que fijamos en relación con la funcionalidad de la plataforma de Messenger y con los mensajes de marketing para mantener el alcance del servicio que te brindamos.

Limitaciones

• Solo puedes enviar una solicitud de suscripción voluntaria a una persona por semana con el mismo título específico. Esta incluye el valor predeterminado de "Actualizaciones y promociones".
• No envíes a una persona solicitudes de suscripción voluntaria duplicadas. Una solicitud de suscripción duplicada se define como tener el mismo title para las notificaciones de una página de Facebook o el mismo title y image_url para las notificaciones de una cuenta profesional de Instagram.
• Solo puedes enviar solicitudes de suscripción voluntaria durante el intervalo de mensajes estándar.
• Si una persona acepta recibir mensajes de marketing, esta acción no abre un intervalo de mensajes estándar.
• Solo puedes ver si una persona aceptó voluntariamente recibir mensajes de marketing, pero no los estados de las solicitudes de suscripción voluntaria pendientes.
• Si una persona eligió dejar de recibir mensajes de marketing, tus notificaciones ya no se le entregarán y recibirás un error.
• Una persona puede bloquear, silenciar o reportar tu mensaje.
• En el caso de los mensajes de marketing que se envían desde una cuenta profesional de Instagram, por lo general, se pueden enviar por usuario hasta 10 solicitudes de suscripción voluntaria en un período de 7 días. Se puede enviar un sublímite de hasta 5 solicitudes de suscripción voluntaria a un usuario en un día. Sin embargo, antes de enviar las solicitudes de suscripción voluntaria, debes considerar si los usuarios probablemente las considerarán pertinentes y valiosas.

Estos requisitos y estas limitaciones están sujetos a cambios, ya que constantemente intentamos mejorar la experiencia de los usuarios y de las empresas.

Prácticas recomendadas

Debes enviar a las personas mensajes de marketing relevantes y valiosos con el fin de crear una experiencia del usuario de alta calidad. Para ello, es necesario hacer lo siguiente:

• Tu solicitud de suscripción voluntaria, incluido el título y la imagen, abarca los tipos de mensajes de marketing que los usuarios pueden esperar recibir, por ejemplo, novedades de pedidos, recomendaciones de productos o determinadas ofertas.

• Al enviar más de una solicitud de suscripción voluntaria a un usuario, cada una de ellas debe indicar claramente los diferentes tipos específicos de mensajes de marketing que el usuario podría recibir.

Los mensajes de marketing deben ser pertinentes y adaptarse a casos de uso que el usuario podría considerar valiosos.

Los usuarios pueden proporcionar comentarios sobre tu experiencia de mensajes, lo que incluye el bloqueo de tus mensajes, que podrían dar lugar a restricciones sobre el uso de los mensajes de marketing por tu parte. Deberías revisar periódicamente tus solicitudes de suscripción voluntaria y mensajes de marketing para comprobar si siguen las prácticas recomendadas mencionadas.

Período de espera para el envío de mensajes

Existe un período de espera de 24 horas para el envío de mensajes de subscription_token. Esto significa que los mensajes de marketing que se envían con el mismo subscription_token requieren un intervalo de 24 horas entre los envíos.

A partir del 1 de septiembre de 2025, el período de espera para el envío de mensajes de suscription_token cambiará de un envío por suscriptor cada 24 horas a un envío cada 48 horas.

Se aplica a tokens de mensajes de notificación creados antes del 2 de febrero de 2023.

• Después de que una persona se suscribe, puedes enviarle mensajes de manera diaria, semanal o mensual, según la frecuencia que seleccionó la persona durante el proceso de suscripción.

Solicitar permiso para enviar mensajes de marketing

Es necesario que una persona dé permiso, es decir, su aceptación de suscripción voluntaria, para que tu página de Facebook o tu cuenta profesional de Instagram pueda enviarle mensajes de marketing. La plataforma de Messenger ofrece diferentes maneras para que te suscribas. Puedes incluir solicitudes de suscripción voluntaria en las siguientes experiencias de mensajes:

• Anuncios de clic a Messenger : cuando una persona hace clic en tu anuncio
• Plugin de casilla : cuando una persona hace clic en la casilla de un formulario y lo envía
• Enlaces m.me: cuando una persona hace clic en el enlace m.me en tu sitio web, correos electrónicos, publicaciones en redes sociales, etc.
• Respuestas privadas : cuando una persona hace una publicación de un visitante o publica un comentario en la página de Facebook de tu negocio
• Códigos QR : cuando una persona escanea tu código QR en superficies digitales o impresas (que admitan enlaces m.me)
• Enviar a plugin de Messenger : cuando una persona inicia una conversación mediante una lista de texto o botones de llamada a la acción predefinidos

Ejemplo de solicitud de suscripción voluntaria

Con el fin de enviar una solicitud de suscripción voluntaria para mensajes de marketing, envía una solicitud POST al punto de conexión /PAGE-ID/messages con el tipo de plantilla de mensaje configurado en notification_messages. El identificador de la página es el identificador de la página de Facebook o de la página de Facebook vinculada a la cuenta profesional de Instagram.

Nota: El parámetro title es obligatorio si se trata de mensajes de marketing que contienen una secuencia de la página de Facebook o la cuenta profesional de Instagram .

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID-OR-IGSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
         "notification_messages_timezone": "UTC",
         "title":"TITLE",
         "image_url":"IMAGE-URL",
         "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Si se realiza correctamente, tu app recibirá la siguiente respuesta JSON, que incluye los identificadores del destinatario y el mensaje.

{ 
        "recipient": {
          "id":"PSID-OR-IGSID",
          "message_id":"MESSAGE-ID",
}

Referencia al objeto del archivo adjunto del mensaje

Se debe incluir un objeto JSON messageattachment en la solicitud POST al punto de conexión /PAGE-ID/messages en relación con la solicitud de suscripción voluntaria a los mensajes de marketing.

Tokens de mensajes de notificación

Cuando una persona se suscriba voluntariamente, tu negocio recibirá una notificación de webhook messaging_optin con un token de mensaje de notificación e información, como el título del mensaje y la zona horaria de la persona que realizó la suscripción voluntaria. El token de mensaje de notificación te permite enviar mensajes de marketing a la persona.

Notificación de webhook de la suscripción voluntaria

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
      "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
      "notification_messages_timezone": "TIMEZONE-ID",
      "token_expiry_timestamp": "TIMESTAMP",
      "user_token_status": "TOKEN-STATUS"  
      "notification_messages_status": "MESSAGE-STATUS", 
      "title": "TITLE-FOR-THE-NOTIFICATION"
    }
}

Se extenderán las fechas de caducidad del token de aquellas personas que hayan elegido mantener la suscripción a los mensajes de marketing. Las personas pueden anular la suscripción en cualquier momento.

Mensajes de seguimiento a personas que se suscribieron

Una vez que una persona se suscribió voluntariamente para recibir mensajes de marketing, puedes enviar hasta tres mensajes de seguimiento. Estos mensajes se deben enviar dentro de un intervalo de dos minutos desde que se envió el primer mensaje de seguimiento. El segundo y el tercer mensaje de seguimiento no pueden superar los 250 caracteres. Estos mensajes de seguimiento se pueden enviar fuera del intervalo de mensajes estándar de 24 horas.

Para enviar un mensaje de seguimiento, envía una solicitud POST al punto de conexión /PAGE-ID/messages con el objeto recipient que contiene el token del mensaje de notificación y el objeto message que contiene el texto de los mensajes de seguimiento. La sintaxis de las solicitudes de la API de los tres mensajes de seguimiento es la misma.

Ejemplo de solicitud

curl -X POST -H "Content-Type: application/json" -d 
    '{ 
        "recipient":{ 
            "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN" 
        }, 
        "message":{ 
            "text":FOLLOWUP-MESSAGE-TEXT-HERE, 
        } 
    }' 
"https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=TOKEN"

Obtener una lista de tokens

Puedes obtener una lista de tokens de mensajes de notificación válidos enviando una solicitud GET al punto de conexión /PAGE-ID/notification_message_tokens.

Ejemplo de solicitud

curl -i -X GET "https://graph.facebook.com/API-VERSION-NUMBER/PAGE-ID/notification_message_tokens
    ?access_token=PAGE-ACCESS-TOKEN"

De manera predeterminada, se devuelve una lista de 25 tokens como máximo y se los ordena según la hora de actualización. Para leer más al respecto, puedes agregar el parámetro limit. En estos momentos, la devolución de tokens tiene un límite de 100. Puedes usar el parámetro after para paginación. Sin embargo, el parámetro before no está disponible.

Si la operación se completa correctamente, tu app recibirá la siguiente respuesta JSON, incluido el token, el identificador del destinatario, ya sea que se trate de un identificador específico de Instagram o de la página, la fecha y hora de creación del token, el título de la notificación y la fecha y hora en que puedes enviar el siguiente mensaje de marketing al destinatario.

{
  "data":[
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-1",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-1",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    },
...
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-25",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-25",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    }
  ],
  "paging":{"cursors":{"before":"QVFIU...","after":"QVFIU..."},"next":"https:\/\/graph.facebook.com\/LATEST-API-VERSION\/PAGE-ID\/notification_message_tokens?access_token=PAGE-ACCESS-TOKEN"}
}

Obtener información del token

Aunque recomendamos usar el webhook messaging_optin para obtener información acerca de los mensajes de marketing, también puedes hacerlo enviando una solicitud GET al punto de conexión del token, donde el token está agregado a notification_messages_NOTIFICATION-MESSAGES-TOKEN y notification_messages_.

Ejemplo de solicitud

curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/notification_messages_NOTIFICATION-MESSAGES-TOKEN
    ?access_token=PAGE-ACCESS-TOKEN"

Si se realiza correctamente, tu app recibirá la siguiente respuesta JSON, que incluye el token de los mensajes de notificación, el identificador de la persona que recibe el mensaje y otra información del token. Usarás el token de mensajes de notificación y el identificador del destinatario para enviar mensajes de marketing.

{
  "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN",
  "recipient_id": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "creation_timestamp": "TIMESTAMP",
  "token_expiry_timestamp": "TIMESTAMP",
  "user_token_status": "REFRESHED",
  "notification_messages_reoptin": "ENABLED",
  "notification_messages_timezone": "TIMEZONE-ID"
  "next_eligible_time": TIMESTAMP
}

Estas llamadas a la API cuentan para la limitación de frecuencia de tu app.

Enviar un mensaje de marketing

Antes de empezar

Necesitarás lo siguiente:

• El token de mensajes de notificación de la persona que aceptó recibir notificaciones
• El identificador de la página de Facebook de tu negocio
• Un token de acceso a la página solicitado por una persona que puede realizar la tarea MESSAGING en la página
• El permiso pages_messaging que usa el inicio de sesión con Facebook
• Cualquier activo que se incluya en el mensaje de marketing
• La suscripción al webhook messaging_referrals de tu app

Para enviar un mensaje de marketing, haz una solicitud POST al punto de conexión /PAGE-ID/messages con el valor NOTIFICATION-MESSAGES-TOKEN del destinatario y la información del mensaje en el archivo adjunto del mensaje.

Limitaciones

• Solo puedes enviar un mensaje por día por token de mensaje de notificación. Si envías varios mensajes, asegúrate de retrasar los mensajes subsiguientes 24 horas. De lo contrario, recibirás un error. (No aplica a Mensajes de seguimiento de las suscripciones voluntarias).

Recomendaciones

• Te recomendamos consultar la zona horaria del destinatario cuando envíes mensajes de marketing para asegurarte de que el destinatario reciba los mensajes en un horario apropiado.

Ejemplo de solicitud

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"generic",
        "elements":[
           {
            "title":"Welcome!",
            "image_url":"https://raw.githubusercontent.com/fbsamples/original-coast-clothing/main/public/styles/male-work.jpg",
            "subtitle":"We have the right hat for everyone.",
            "default_action": {
              "type": "web_url",
              "url": "https://www.originalcoastclothing.com/",
              "webview_height_ratio": "tall"
            },
            "buttons":[
              {
                "type":"web_url",
                "url":"https://www.originalcoastclothing.com/",
                "title":"View Website"
              },{
                "type":"postback",
                "title":"Start Chatting",
                "payload":"ADDITIONAL-WEBHOOK-INFORMATION"
              }              
            ]      
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Si la operación se completa con éxito, tu app recibirá la siguiente respuesta:

{ 
  "recipient": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "message_id": "MESSAGE-ID"      
}

Probar mensajes de marketing

Puedes probar los mensajes de marketing en cualquier momento.

Antes de empezar

Necesitarás lo siguiente:

• Una persona, el evaluador, para recibir la notificación. Esta persona debe tener un rol en la app.

Probar suscripciones voluntarias

Puedes probar los mensajes de marketing en cualquier momento si sigues estos pasos.

• Paso 1: Envía un mensaje al evaluador con una plantilla de suscripción voluntaria a los mensajes de marketing.
• Paso 2: Asegúrate de que en la conversación el evaluador haga clic en el botón de suscripción voluntaria, como Recibir mensajes de ofertas con 50% de descuento.
• Paso 3: Envía el primer mensaje de marketing a tu evaluador.
• Paso 4. Envía otro mensaje de marketing inmediatamente después del primero con el parámetro developer_action configurado en ENABLE_FOLLOWUP_MESSAGE.
• Paso 5: Envía otro mensaje de marketing al evaluador; este será el mensaje de prueba.

Ejemplo de solicitud

curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

Si se hace correctamente, tu app recibirá la siguiente respuesta JSON donde success será true.

{ "success": true }

Para probar las reactivaciones de suscripción voluntaria, repite los pasos del paso 4 con el parámetro developer_action configurado en SEND_RE_OPTIN.

Próximos pasos

• Notificación de webhook relativa a la suscripción de mensajes
• Consulta la información general sobre tipos de mensajes para obtener información sobre los diferentes tipos de mensajes que puedes enviar.

Más información

• Consulta la referencia de los mensajes de la página para obtener más información sobre los campos disponibles en los mensajes recurrentes.
• Una lista de zonas horarias disponibles
• Códigos de error de la plataforma de Messenger