Mensajes de marketing

En este documento se explica cómo solicitar permiso a un usuario para enviar mensajes de marketing, se presentan las limitaciones y los requisitos específicos para el envío de solicitudes, y se incluye información sobre la creación y el envío de solicitudes de permisos 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 los usuarios que hayan dado permiso para ello. Los mensajes de marketing te permiten entablar relaciones con usuarios que están interesados en ti o en tu empresa.

Los mensajes de marketing son una nueva función opcional y premium por la que pretendemos cobrar en el futuro. En estos momentos, cobramos a las empresas por enviar mensajes desde la API de WhatsApp Business y tenemos en cuenta los comentarios de los clientes a la hora de tomar decisiones sobre nuestro modelo de precios. Informaremos a los clientes y socios acerca de cualquier cambio que realicemos en la prueba gratuita con suficiente antelación.

Requisitos

• Debes cumplir todas las políticas para desarrolladores aplicables al usar los mensajes de marketing u otras funciones de la plataforma de Messenger.

• Solo se puede enviar una solicitud para que un usuario se suscriba voluntariamente a los mensajes de marketing durante el transcurso del intervalo estándar de mensajes. La acción de suscribirse voluntariamente a los mensajes de marketing por parte de un usuario no abre el intervalo de mensajes estándar.

• La aplicación o experiencia de mensajes no debe recibir un número excesivo de comentarios negativos de los usuarios. Es posible que se restrinjan o eliminen las funciones de mensajes si determinamos que la experiencia de mensajes de tu aplicación ha recibido demasiados comentarios negativos de los usuarios.

• No se permite usar los mensajes de marketing, incluidas las solicitudes de suscripción voluntaria, para enviar spam a los usuarios. Esto incluye enviar solicitudes de suscripción voluntaria duplicadas con mucha frecuencia al mismo usuario o usuarios y otros tipos de spam según se define en nuestras políticas para desarrolladores.

• Debes respetar los límites establecidos para la funcionalidad de la plataforma de Messenger y los mensajes de marketing a fin de mantener el alcance del servicio que te ofrecemos.

Limitaciones

• Solo puedes enviar una solicitud de suscripción voluntaria cada semana con el mismo título concreto a un usuario. Esto incluye el valor predeterminado de “Actualizaciones y promociones”.
• No envíes solicitudes de suscripción voluntaria duplicadas a un usuario. Una solicitud de suscripción voluntaria duplicada implica tener el mismo valor de title en el caso de las notificaciones de una página de Facebook o los mismos valores de title y image_url en el caso de las notificaciones de una cuenta profesional de Instagram.
• Solo puedes enviar solicitudes de suscripción voluntaria durante el intervalo de mensajes estándar.
• Si alguien se suscribe voluntariamente a mensajes de marketing, esta acción no abre un intervalo de mensajes estándar.
• Solo puedes consultar si un usuario se ha suscrito voluntariamente para recibir mensajes de marketing, pero no los estados de las solicitudes de suscripción voluntaria pendientes.
• Si una persona ha decidido dejar de recibir mensajes de marketing, tus notificaciones ya no se entregarán a esa persona y recibirás un error.
• Un usuario puede bloquear, silenciar o denunciar tus mensajes.
• En el caso de los mensajes de marketing enviados desde una cuenta profesional de Instagram, por lo general se pueden enviar un máximo de 10 solicitudes de suscripción voluntaria para diferentes títulos por usuario durante un periodo de siete días. Se aplica también un sublímite de cinco solicitudes de suscripción voluntaria por usuario y por día. Sin embargo, antes de enviarlas, debes plantearte si estas solicitudes de suscripción voluntaria resultarán pertinentes y útiles para los usuarios.

Estos requisitos y límites podrían cambiar, ya que nuestro objetivo es ofrecer la mejor experiencia de usuario y empresarial.

Prácticas recomendadas

Envía mensajes de marketing que resulten pertinentes y útiles a fin de crear una experiencia de usuario excelente de la siguiente manera:

• La solicitud de suscripción voluntaria, incluido el título y la imagen, debe incluir los tipos de mensajes de marketing que los usuarios podrían recibir, como actualizaciones sobre pedidos, recomendaciones de productos y ofertas.

• Si envías más de una solicitud de suscripción voluntaria a un usuario, cada una deberá definir de forma clara los distintos tipos de mensajes de marketing que el usuario podría recibir.

Los mensajes de marketing deben ser pertinentes y estar adaptados a casos de uso que puedan resultarles útiles a los usuarios.

Los usuarios pueden enviar comentarios sobre la experiencia de mensajes que ofreces, así como bloquear los mensajes, lo que podría derivar en restricciones a la hora de usar los mensajes de marketing. Debes revisar las solicitudes de suscripción voluntaria y los mensajes de marketing con regularidad para ver si cumplen las prácticas recomendadas mencionadas.

Frecuencia de mensajes

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

• Cuando un usuario se suscribe de forma voluntaria, puedes enviarle mensajes con una frecuencia diaria, semanal o mensual en función de la frecuencia que el usuario haya seleccionado durante la suscripción voluntaria.

Solicitar permiso para enviar mensajes de marketing

Un usuario debe conceder permiso (suscribirse voluntariamente) para recibir mensajes de marketing de tu página de Facebook o cuenta profesional de Instagram. La plataforma de Messenger te ofrece diversas formas para obtener la suscripción voluntaria. Puedes crear solicitudes de suscripción voluntaria en las siguientes experiencias de mensajes:

• Anuncios de clic a Messenger : cuando un usuario hace clic en tu anuncio.
• Plugin “Checkbox” : cuando un usuario hace clic en la casilla de un formulario y lo envía.
• Enlaces m.me: cuando un usuario hace clic en el enlace m.me de tu sitio web, mensajes de correo electrónico, publicaciones de medios sociales, etc.
• Respuestas privadas : cuando un usuario hace un comentario o una publicación de visitante en la página de Facebook de tu empresa.
• Códigos QR : cuando un usuario escanea tu código QR en superficies digitales e impresas (los enlaces m.me los admiten).
• Plugin “Enviar a Messenger” : cuando un usuario 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

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

Nota: El parámetro title es obligatorio para los mensajes de marketing que contienen una secuencia de tu página de Facebook o 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 la operación se realiza correctamente, la aplicación recibirá la siguiente respuesta JSON, que incluye los identificadores del destinatario y del mensaje.

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

Referencia del objeto de archivo adjunto de mensaje

En el caso de una solicitud de suscripción voluntaria a mensajes de marketing, se debe incluir un objeto JSON attachment de message en la solicitud POST al extremo /PAGE-ID/messages.

Identificadores de mensajes de notificación

Cuando un usuario se suscribe voluntariamente, tu empresa recibirá una notificación del webhooks messaging_optin con un identificador de mensaje de notificación e información como el título del mensaje y la zona horaria del usuario que se ha suscrito. El identificador de mensaje de notificación te permite enviar mensajes de marketing al usuario.

Notificación de webhook de 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"
    }
}

Las fechas de caducidad de los identificadores se ampliarán para los usuarios que elijan seguir recibiendo mensajes de marketing. La suscripción se puede anular en cualquier momento.

Mensajes de seguimiento de suscripción voluntaria

Cuando un usuario se haya suscrito voluntariamente para recibir mensajes de marketing, puedes enviar un máximo de tres mensajes de seguimiento. Estos mensajes deben enviarse durante los dos minutos posteriores al primer mensaje de seguimiento. El segundo y 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 extremo /PAGE-ID/messages con el identificador de mensaje de notificación en el objeto recipient y el texto de los mensajes de seguimiento en el objeto message. La sintaxis de las solicitudes a 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 identificadores

Para obtener una lista de todos los identificadores válidos de mensajes de notificación, envía una solicitud GET al extremo /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 forma predeterminada, se devuelve una lista de un máximo de 25 identificadores ordenados según la hora de actualización. Para obtener más información, puedes añadir el parámetro limit. Actualmente, el límite de identificadores que se pueden devolver está en 100. Puedes usar el parámetro after para la paginación; en cambio, el parámetro before no está disponible.

Si la operación se realiza correctamente, la aplicación recibirá la siguiente respuesta JSON, que incluye el identificador, el identificador del destinatario (un identificador específico de Instagram o un identificador específico de la página), la hora de creación del identificador, el título de la notificación y la hora a la que puedes enviar el siguiente mensaje de marketing a dicho 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 identificador

Aunque recomendamos usar el webhook messaging_optin para recopilar información de los mensajes de marketing, puedes enviar una solicitud GET al extremo del identificador cuando el identificador se anexe a notification_messages_ (notification_messages_NOTIFICATION-MESSAGES-TOKEN) para obtener información de dicho identificador.

Ejemplo de solicitud

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

Cuando esta operación se completa correctamente, la aplicación recibe la respuesta JSON siguiente, que incluye el identificador de mensajes de notificación, el identificador del usuario que va a recibir el mensaje y otra información sobre los identificadores. Podrás usar el identificador 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 se tendrán en cuenta para el límite de frecuencia de la aplicación.

Enviar un mensaje de marketing

Antes de empezar

Necesitarás lo siguiente:

• El identificador del mensaje de notificación del usuario que se ha suscrito de forma voluntaria a la recepción de notificaciones.
• El identificador de la página de Facebook de tu empresa.
• Un identificador de acceso a la página solicitado por un usuario que pueda realizar la tarea MESSAGING en la página.
• El permiso pages_messaging, mediante el inicio de sesión con Facebook.
• Los activos que se van a incluir en el mensaje de marketing.
• La suscripción al webhook messaging_referrals de tu aplicación.

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

Limitaciones

• Solo puedes enviar un mensaje al día por identificador de mensaje de notificación. Si vas a enviar varios mensajes, asegúrate de retrasar los mensajes posteriores 24 horas; de lo contrario, recibirás un error. (No se aplica a los mensajes de seguimiento de suscripción voluntaria.)

Recomendaciones

• Te recomendamos encarecidamente que hagas referencia a la zona horaria de un destinatario al enviar mensajes de marketing para garantizar que los mensajes se reciban a una hora adecuada para el destinatario.

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"

Cuando esta operación se completa correctamente, la aplicación recibe la respuesta siguiente:

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

Probar los mensajes de marketing

Puedes probar los mensajes de marketing en cualquier momento.

Antes de empezar

Necesitarás lo siguiente:

• Un usuario (el evaluador) para recibir la notificación. Dicho usuario debe tener un rol en la aplicación.

Probar las suscripciones voluntarias

Puedes probar los mensajes de marketing en cualquier momento, siguiendo estos pasos.

• Paso 1. Envía al evaluador un mensaje con una plantilla de suscripción voluntaria a mensajes de marketing.
• Paso 2. Asegúrate de que el evaluador haga clic en el botón de suscripción voluntaria (como Recibir mensajes de ofertas del 50 % de descuento) de la conversación.
• Paso 3. Envía el primer mensaje de marketing al evaluador.
• Paso 4. Envía otro mensaje de marketing inmediatamente después del primero, con el parámetro developer_action establecido en ENABLE_FOLLOWUP_MESSAGE.
• Paso 5. Envía otro mensaje de marketing al evaluador; este es tu 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"

Cuando esta operación se completa correctamente, la aplicación recibe la respuesta JSON siguiente con el valor de success establecido en true.

{ "success": true }

A fin de probar las solicitudes para volver a suscribirse de forma voluntaria, repite los pasos con el parámetro developer_action establecido en SEND_RE_OPTIN en el paso 4.

Siguientes pasos

• Notificación de webhooks de suscripción voluntaria a mensajes
• Consulta la información general sobre los tipos de mensajes para obtener información sobre los distintos tipos de mensajes que puedes enviar.

Más información

• Referencia de los mensajes de página : información sobre los campos disponibles para los mensajes recurrentes.
• Lista de las zonas horarias disponibles
• Códigos de error para la plataforma de Messenger