Enviar un mensaje

En este documento se incluyen los requisitos para enviar mensajes de formato libre desde tu cuenta profesional de Instagram a los clientes o usuarios interesados en tu cuenta mediante la plataforma de Messenger de Meta.

Puedes enviar un mensaje de formato libre que incluya lo siguiente:

• Una imagen, un vídeo, un gif o un audio.
• Una reacción o un sticker.
• Texto, incluido un enlace.

Antes de empezar

En esta guía se supone que has leído la información general sobre la plataforma de Messenger y has implementado los componentes necesarios, como una página de Facebook vinculada a tu cuenta profesional de Instagram (o página de prueba). Debes estar registrado como desarrollador de Meta y crear un identificador de aplicación empresarial con el producto de Messenger > Mensajes de Instagram en el panel de aplicaciones.

También es posible que quieras consultar el estado de la plataforma para desarrolladores de Meta a fin de asegurarte de que no hay ningún problema.

Requisitos

• El identificador de la página de Facebook vinculada a tu cuenta profesional de Instagram.
• El identificador específico de Instagram del cliente que envió un mensaje a tu empresa.
• Un identificador de acceso a la página solicitado por un usuario que pueda realizar la tarea MESSAGE en la página de Facebook vinculada a la cuenta profesional de Instagram.
• El permiso instagram_manage_messages.

Limitaciones

• Las aplicaciones con acceso estándar solo pueden enviar mensajes a los usuarios que tienen un rol en ella.
• Los archivos multimedia adjuntos pueden ser:

Para obtener más información sobre los archivos multimedia adjuntos, consulta Subir contenido multimedia para mensajes de Instagram.

Enviar un mensaje básico

Para enviar un mensaje que contenga texto o un enlace, envía una solicitud POST al extremo /PAGE-ID/messages con el identificador específico de Instagram (IGSID) en el parámetro recipient y el texto o el enlace en el parámetro message.

El texto del mensaje debe estar en formato UTF-8 y tener 1000 bytes o menos. Los enlaces deben ser URL con un formato válido.

Ejemplo de solicitud

Se ha aplicado formato para mejorar la legibilidad.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={"text":"TEXT-OR-LINK"}'

Ejemplo de respuesta de API

Cuando esta operación se complete correctamente, la aplicación recibirá la respuesta JSON siguiente:

{
  "recipient_id": "IGSID",
  "message_id": "MESSAGE-ID"
}

Enviar una publicación

Para enviar un mensaje que contenga una publicación realizada en Instagram, envía una solicitud POST al extremo /PAGE-ID/messages con el identificador específico de Instagram (IGSID) en el parámetro recipient y un objeto attachment en el parámetro message. Dicho objeto debe tener el valor de type establecido en MEDIA_SHARE e incluir el identificador de Meta de la publicación en payload.

La empresa debe ser la propietaria del contenido multimedia que se va a usar en el mensaje.

Ejemplo de solicitud

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={
      "attachment": 
        {
          "type":"MEDIA_SHARE", 
          "payload":{"id":"POST-ID"}
        }
}’

Ejemplo de respuesta de API

Cuando esta operación se complete correctamente, la aplicación recibirá la respuesta JSON siguiente:

{
  "recipient_id": "IGSID",
  "message_id": "MESSAGE-ID"
}

Enviar un sticker

Para enviar un sticker de corazón, envía una solicitud POST al extremo /PAGE-ID/messages con el identificador específico de Instagram (IGSID) en el parámetro recipient y un objeto attachment en el parámetro message. Dicho objeto debe tener el valor de type establecido en like_heart.

Ejemplo de solicitud

Se ha aplicado formato para mejorar la legibilidad.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={
      "attachment": 
        {
          "type":"like_heart"
        }
}’

Ejemplo de respuesta de API

Cuando esta operación se complete correctamente, la aplicación recibirá la respuesta JSON siguiente:

{
  "recipient_id": "IGSID",
  "message_id": "MESSAGE-ID"
}

Reaccionar a un mensaje

Para enviar una reacción, envía una solicitud POST al extremo /PAGE-ID/messages con el identificador específico de Instagram (IGSID) en el parámetro recipient y el parámetro sender_action establecido en react, con el valor de message_id establecido en el identificador del mensaje al que se va a aplicar la reacción y el valor de reaction establecido en love en el parámetro payload.

Ejemplo de solicitud

Se ha aplicado formato para mejorar la legibilidad.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&sender_action=react&payload={
      "message_id":"MESSAGE-ID",
      "reaction":"love",
}'

Para eliminar una reacción de un mensaje, envía una solicitud POST al extremo /PAGE-ID/messages con el identificador específico de Instagram (IGSID) en el parámetro recipient y el parámetro sender_action establecido en unreact, con el valor de message_id establecido en el identificador del mensaje del que se va a eliminar la reacción en el parámetro payload.

Ejemplo de solicitud

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id”:”IGSID”}&sender_action="unreact"&payload={
      “message_id":"MESSAGE-ID",
}'

Ejemplo de respuesta

Cuando esta operación se lleve a cabo correctamente, la aplicación recibirá la siguiente respuesta JSON en el caso de las solicitudes de reacción o anulación de la reacción:

{
  "recipient_id": "IGSID"
}

Siguientes pasos

• Sube contenido multimedia, como audio o imágenes a los servidores de Meta para usarlo en múltiples mensajes.

• Envía un mensaje estructurado, como una plantilla genérica, una plantilla de producto o un menú persistente.

Más información

• Códigos de error
• Límites de frecuencia para mensajes de Instagram
• Obtener el identificador de contenido multimedia de los activos multimedia