Enviar un mensaje

Para enviar mensajes a un usuario en Messenger o Instagram, es el usuario quien debe iniciar la conversación. En la plataforma de Messenger hay varios tipos de mensajes que puedes enviar. Cada tipo de mensaje tiene distintas políticas y normas en lo que concierne a los tipos de contenido que se pueden enviar y las condiciones para dicho envío.

Componentes de los mensajes

Todas las solicitudes realizadas a la API de envío desde tu aplicación para enviar un mensaje deben incluir lo siguiente:

• El identificador de la página de Facebook, o la página de Facebook vinculada a la cuenta profesional de Instagram, que va a enviar el mensaje.
• El identificador del usuario que va a recibir el mensaje.
• Un identificador de acceso a la página solicitado de la página que va a enviar el mensaje.
• Permiso del usuario que va a recibir el mensaje.
• El tipo de mensaje.
• El contenido del mensaje.

Para obtener más información sobre los componentes de los mensajes, consulta lareferencia de la API de envío.

Intervalo de mensajes estándar

El intervalo de mensajes estándar es el periodo de 24 horas durante el que puedes enviar un mensaje a un usuario. Cuando un usuario envía a tu página o cuenta profesional de Instagram un mensaje o inicia una conversación mediante un plugin web, la aplicación tiene 24 horas como máximo para enviar un mensaje.

Los mensajes enviados en dicho intervalo de 24 horas pueden incluir contenido promocional.

Acciones del usuario que inician el intervalo de mensajes estándar

Las siguientes acciones del usuario inician el intervalo de mensajes estándar de 24 horas:

• Un usuario envía un mensaje a tu página o cuenta profesional de Instagram.
• Un usuario hace clic en un botón de llamada a la acción, como, por ejemplo, “Empezar”, en una conversación.
• Un usuario hace clic en un anuncio de clic a Messenger y, a continuación, envía un mensaje a tu página o cuenta profesional de Instagram.
• Un usuario envía un mensaje a una página mediante un plugin, como el plugin Enviar a Messenger o Checkbox.
• Un usuario hace clic en un enlace m.me que lo dirige a una conversación existente entre el usuario y la página.
• Un usuario hace clic en un enlace ig.me que lo dirige a una conversación existente entre el usuario y la cuenta profesional de Instagram.
• Un usuario reacciona a un mensaje, como un mensaje de marketing.
• Un usuario comenta en una publicación de tu página o cuenta profesional de Instagram.
• Un usuario realiza una publicación de visitante en tu página.

Sabemos que los usuarios esperan recibir una respuesta inmediata, por lo que te recomendamos encarecidamente que respondas lo antes posible durante el transcurso de dicho intervalo de 24 horas. Los usuarios tienen la opción de bloquear o silenciar una conversación en cualquier momento.

Identificadores de destinatario

El identificador de un usuario que va a recibir el mensaje se establece en el parámetro del objeto recipient y puede ser uno de los siguientes tipos de identificador:

• Identificador específico de la página (PSID): identificador asignado a un usuario la primera vez que envía un mensaje a tu página. Este identificador único representa interacciones entre tu página y el usuario.

• Referencia del usuario: identificador asignado a un usuario que utilizó un plugin o botón de postback para enviar un mensaje a tu página.

• Identificador de la publicación o el comentario: identificador asignado a un usuario que realizó una publicación en tu página o comentó en una publicación. Se utiliza para enviar una respuesta privada al usuario.

Ten en cuenta que los identificadores de usuario de las integraciones del inicio de sesión con Facebook son específicos de la aplicación y no funcionarán en la plataforma de Messenger.

Tipos de mensajes

El tipo de mensaje que vas a enviar se establece en el parámetro messaging_type. Al usar este parámetro, te aseguras de forma más explícita de que los mensajes cumplan con las políticas de mensajes y las preferencias del destinatario.

Se admiten los siguientes tipos de mensajes:

• Respuesta: el mensaje que vas a enviar es una respuesta a un mensaje recibido. El mensaje puede incluir contenido promocional y no promocional y se debe enviar durante el intervalo de mensajes estándar.

• Actualizaciones: el mensaje que vas a enviar se envía de forma proactiva y no es una respuesta a un mensaje recibido. El mensaje puede incluir contenido promocional y no promocional y se debe enviar durante el intervalo de mensajes estándar.

• Mensaje etiquetado: el mensaje que vas a enviar se envía una vez transcurrido el intervalo de mensajes estándar. Este mensaje debe incluir una etiqueta de mensaje que coincida con el caso de uso en el que se permite la etiqueta e incluye contenido no promocional.

Etiquetas de mensajes

Las etiquetas de mensajes te permiten enviar un mensaje una vez transcurrido el intervalo de mensajes estándar. Estos mensajes son actualizaciones pertinentes a título personal para un usuario. Por ejemplo, puedes enviar actualizaciones sobre envíos y entregas, avisos de la proximidad de una reserva o un vuelo, o alertas relativas a la cuenta de un cliente. En el caso de los procesos de mensajes que requieren una vía de remisión, la etiqueta de agente humano permite a un representante de la empresa responder manualmente a los mensajes de un usuario en un periodo de siete días.

Las etiquetas de mensajes no se pueden utilizar para enviar contenido promocional, como ofertas, cupones, descuentos, etc. El uso de las etiquetas de mensajes fuera de los casos de uso aprobados podría restringir la capacidad de la página o la cuenta de Instagram para enviar mensajes. Consulta la política de la API de mensajes de Instagram y la plataforma de Messenger para obtener más información.

Las empresas que utilizan la plataforma de Messenger y quieren enviar mensajes promocionales una vez transcurrido el intervalo de mensajes estándar de 24 horas deben utilizar mensajes publicitarios o notificaciones únicas.

Tipos de contenido

El mensaje que envíes puede incluir los siguientes tipos de contenido:

Enviar un mensaje de texto básico

Para enviar un mensaje de texto básico a un usuario que haya enviado un mensaje a tu página, envía una solicitud POST al extremo /PAGE-ID/messages, con el valor de id de la clave del literal del objeto recipient establecido en el identificador específico de la página (PSID) del usuario, el parámetro message_type establecido en RESPONSE y el valor de text del objeto del parámetro message establecido en el texto del mensaje.

Ejemplo de solicitud

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text":"Hello, world!"
  }
}' "https://graph.facebook.com/v25.0/{PAGE-ID}/messages?access_token={PAGE-ACCESS-TOKEN}"
    

Si la operación se realiza correctamente, la aplicación recibirá la siguiente respuesta JSON con el identificador del destinatario y el identificador del mensaje.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

Enviar un archivo multimedia adjunto

Para enviar un mensaje con un archivo multimedia (como un GIF, una imagen o una plantilla), debes añadir el contenido a la solicitud de la API en un objeto de archivo adjunto de mensaje JSON.

Para enviar un mensaje con una imagen a un usuario que haya enviado un mensaje a tu página, envía una solicitud POST al extremo /PAGE-ID/messages, con el valor de id de la clave del literal del objeto recipient establecido en el identificador específico de la página (PSID) del usuario, el parámetro message_type establecido en RESPONSE, la clave type del objeto attachment del parámetro message establecida en image y la clave url del objeto payload establecida en la URL de la imagen.

Ejemplo de solicitud

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"1254459154682919"
  },
  "message":{
    "attachment":{
      "type":"image", 
      "payload":{
        "url":"http://www.messenger-rocks.com/image.jpg", 
        "is_reusable":true
      }
    }
  }
}' "https://graph.facebook.com/v25.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"
  

Si la operación se realiza correctamente, la aplicación recibirá la siguiente respuesta JSON con el identificador del destinatario y el identificador del mensaje.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

Al enviar audio, un vídeo o un archivo desde una URL se usará el mismo formato.

También puedes enviar archivos multimedia desde tu servidor o desde contenido que hayas subido previamente a un servidor de Meta. Obtén más información sobre cómo subir archivos con la API de subida de archivos adjuntos.

Enviar varios archivos multimedia adjuntos

Para enviar un mensaje con varias imágenes, debes añadir el contenido a la solicitud de la API en una matriz de archivo adjunto de mensaje JSON. El único tipo de archivo multimedia admitido son las imágenes, y están limitadas a 30 imágenes a la vez.

Para enviar un mensaje con varias imágenes a un usuario que haya enviado un mensaje a tu página, envía una solicitud POST al extremo /PAGE-ID/messages con el valor de id de la clave del literal del objeto recipient establecido en el identificador específico de la página (PSID) del usuario, el parámetro message_type establecido en RESPONSE, y el parámetro message con una matriz attachments en la que la clave type de cada objeto adjunto esté establecida en image y la clave url del objeto payload esté establecida en la URL de la imagen.

Ejemplo de solicitud

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "1254459154682919"
  },
  "message": {
    "attachments": [
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      },
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      }
    ]
  }
}' "https://graph.facebook.com/v25.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"
  

Si la operación se realiza correctamente, la aplicación recibirá la siguiente respuesta JSON con el identificador del destinatario y el identificador del mensaje.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

Enviar una respuesta a un mensaje

Para responder a un mensaje anterior específico del chat, envía una solicitud POST a /PAGE-ID/messages que incluya lo siguiente:

• El id de la clave literal del objeto recipient establecido en el identificador específico de la página de la persona (PSID)
• message_type establecido en RESPONSE
• Los detalles del mensaje en el objeto de parámetro del mensaje
• El mid de la clave literal del objeto reply_to establecido en el identificador de mensaje del mensaje específico del chat al que deseas responder

El mensaje puede ser el enviado por tu página o por el usuario.

Ejemplo de solicitud

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "<PSID>",
  }
  "messaging_type": "RESPONSE"
  "message": {
    "text": "Hello, world!"      
  },
  "reply_to": {
    "mid": "{MESSAGE_ID}"
  }
}' "https://graph.facebook.com/v23.0/{PAGE-ID}/messages?access_token={PAGE_ACCESS_TOKEN}" 

Si la operación se realiza correctamente, la aplicación recibirá la siguiente respuesta JSON con el identificador del destinatario y el identificador del mensaje.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U…"
} 

Prácticas recomendadas

Mensajes de texto

• Sé breve. Ten en cuenta el tamaño de la pantalla y las posibilidades de desplazamiento. Los mensajes concisos son más fáciles de leer. Intenta enviar varios mensajes en lugar de uno largo.
• No utilices texto como sustituto de imágenes, tablas y gráficos. Es posible que los mensajes estructurados o incluso una vista web se adapten mejor a tus necesidades.
• No escribas mensajes largos. Si necesitas comunicar varias cosas, envía varios mensajes en lugar de uno largo.

Archivos adjuntos

• Presta atención a la calidad. Utiliza imágenes coloridas y en alta resolución para que los mensajes destaquen.
• Ten en cuenta la relación de aspecto. Investiga cómo podría recortarse la imagen al aparecer en el cuadro de mensaje.
• No incluyas mucho texto en la imagen. Utiliza en su lugar un mensaje de texto o combina imágenes y texto con una plantilla genérica.

Más tipos de mensajes

Mensajes de marketing

Los mensajes de marketing te permiten solicitar permiso a un usuario para enviar varios mensajes de marketing una vez transcurrido el intervalo de mensajes estándar. Si el usuario acepta esta solicitud para recibir estas notificaciones, podrás enviarle mensajes promocionales recurrentes y automatizados con información sobre próximas ofertas o novedades y lanzamientos de productos.

Mensajes de noticias (en desarrollo)

Los mensajes de noticias solo están disponibles para los editores de noticias registrados en el índice de páginas de noticias de Facebook (NPI). Los mensajes de noticias permiten a los editores de noticias enviar mensajes de noticias no promocionales a los usuarios que se han suscrito para recibirlos.

Los mensajes de noticias no están disponibles para la API de mensajes de Instagram.

Notificación única

Las notificaciones únicas te permiten solicitar permiso a un usuario para enviar un mensaje de seguimiento una vez transcurrido el intervalo de mensajes estándar. Si el usuario acepta esta solicitud para recibir una notificación única, podrás enviar un mensaje que sea urgente y pertinente a título personal, como un recordatorio de una cita o una alerta sobre productos que vuelven a estar disponibles.

Las notificaciones únicas no están disponibles para la API de mensajes de Instagram.

Respuestas privadas

Las respuestas privadas te permiten enviar un mensaje a un usuario cuando publique un comentario en uno de tus anuncios o publicaciones, o realice una publicación de visitante en tu página o cuenta profesional de Instagram. La respuesta privada solo puede ser un único mensaje, que automáticamente incluye un enlace a la publicación o el comentario, y se debe enviar en un plazo de siete días desde que el usuario realice la publicación o deje el comentario.

Mensajes publicitarios

Los mensajes publicitarios te permiten enviar contenido promocional y no promocional después de que haya caducado el intervalo de mensajes estándar a un usuario que haya enviado previamente un mensaje a tu página o cuenta profesional de Instagram. Los mensajes publicitarios tienen un aspecto similar a los mensajes normales en la conversación, pero incluyen la palabra “Publicidad” encima. El contenido de los mensajes publicitarios debe cumplir las políticas de publicidad.

Los mensajes publicitarios no están disponibles para la API de mensajes de Instagram.

Mensajes de utilidad

Los mensajes de utilidad te permiten enviar mensajes de plantilla aprobados previamente que incluyen información sobre pedidos, actualizaciones de cuentas y citas. Estos mensajes están personalizados con números de cuenta, identificadores de pedidos, números de seguimiento de envíos, fecha y hora de las citas y pueden incluir llamadas a la acción que permitan al usuario cancelar un pedido, reprogramar una cita y otras acciones que faciliten la interacción con la empresa.

Siguientes pasos

Obtén información sobre los componentes que puedes añadir a los mensajes de tus conversaciones.

Más información

Obtén más información sobre el envío de mensajes con la plataforma de Messenger.

• Referencia de la API de subida de archivos adjuntos: obtén más información sobre cómo subir y enviar contenido multimedia.
• Referencia de la API de envío: obtén más información sobre todas las etiquetas, el contenido y los archivos adjuntos que puedes enviar.
• Límites de frecuencia: obtén más información sobre los límites de frecuencia del envío de mensajes con la plataforma de Messenger.