Enviar un mensaje

Para poder enviar mensajes a una persona en Messenger o Instagram, es necesario que la persona inicie la conversación. La plataforma de Messenger ofrece varios tipos de mensajes que puedes enviar. Los tipos de mensajes deben cumplir con políticas y normas diferentes que establecen qué tipo de contenido se puede enviar y en qué condiciones.

Componentes de mensajes

Todas las solicitudes de la API de envío que salgan de tu app 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 envía el mensaje
• El identificador de la persona que recibe el mensaje
• Un token de acceso a la página solicitado por la página que envía el mensaje
• El permiso de la persona que recibe el mensaje
• El tipo de mensaje
• El contenido del mensaje

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

Intervalo estándar para enviar mensajes

El intervalo estándar para enviar mensajes es el período de 24 horas en el que tienes permitido enviar un mensaje a una persona. Cuando una persona envía un mensaje a tu página o cuenta profesional de Instagram o inicia una conversación a través del plugin web, tu app dispone de un plazo de 24 horas para enviar un mensaje.

Los mensajes enviados en el transcurso de 24 horas pueden tener contenido promocional.

Acciones del usuario que inician el intervalo estándar para enviar mensajes

Las siguientes acciones de los usuarios inician el intervalo estándar de 24 horas para el envío de mensajes:

• Una persona envía un mensaje a tu página o cuenta profesional de Instagram
• Una persona hace clic en un botón de llamada a la acción como “Empezar” en una conversación
• Una persona hace clic en un anuncio de clic a Messenger y luego envía un mensaje a tu página o cuenta profesional de Instagram
• Una persona envía un mensaje a una página a través de un plugin como el de Enviar a Messenger o el de casilla
• Una persona hace clic en un enlace m.me que la lleva a una conversación anterior entre la persona y la página
• Una persona hace clic en un enlace de ig.me que la lleva a una conversación anterior entre la persona y la cuenta profesional de Instagram
• Una persona reacciona a un mensaje, como un mensaje de marketing
• Una persona comenta una publicación en tu página o cuenta profesional de Instagram
• Una persona hace una publicación de visitante en tu página

Sabemos que las personas esperan una respuesta pronta; por ello, te recomendamos que respondas lo antes posible dentro de este plazo de 24 horas. Las personas tienen la opción de bloquear o silenciar una conversación en cualquier momento.

Identificadores de destinatarios

El identificador de una persona que recibe el mensaje se configura en el parámetro objeto recipient y puede ser uno de los siguientes tipos de identificador:

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

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

• Identificador de publicación o comentario: un identificador asignado a una persona que hizo una publicación en tu página o comentó en una publicación. Se usa para enviar una respuesta privada a la persona.

Ten en cuenta que el identificador de usuario de las integraciones del inicio de sesión con Facebook es específico de la app y no funcionará con la plataforma de Messenger.

Tipos de mensajes

El tipo de mensaje que envías se define mediante el parámetro messaging_type. Este parámetro es una forma más explícita de garantizar que tu mensaje cumple con las políticas de envío de mensajes y las preferencias del destinatario.

Se admiten los siguientes tipos de mensajes:

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

• Actualizaciones: el mensaje se envía de manera proactiva y no como respuesta a un mensaje recibido. El mensaje puede incluir contenido promocional y no promocional, y se debe enviar durante el intervalo estándar de envío de mensajes.

• Mensaje etiquetado: el mensaje se envía fuera del intervalo estándar para el envío de mensajes. Este mensaje debe incluir una etiqueta que coincida con el caso de uso permitido y debe incluir contenido no promocional.

Etiquetas de mensajes

Las etiquetas de mensajes te permiten enviar mensajes fuera del intervalo de mensajes estándar. Estos mensajes son actualizaciones personalmente relevantes para una persona. Por ejemplo, podrías enviar actualizaciones sobre envíos o entregas, una reserva o un vuelo próximos, o alertas sobre una cuenta del cliente. En el caso de los flujos de mensajes que requieren una ruta de escalamiento, la etiqueta "Agente Humano" permite a un representante del negocio responder manualmente a los mensajes de una persona en un período de 7 días.

Es posible que las etiquetas de los mensajes no se usen para enviar contenido promocional, como ofertas, cupones y descuentos, entre otros. El uso de etiquetas de mensajes fuera de los casos de uso aprobados puede hacer que se restrinja la capacidad de enviar mensajes que tiene la página o la cuenta de Instagram. Si quieres obtener más información, consulta la Política de la plataforma de Messenger y de la API de mensajes para Instagram.

Las empresas que usen la plataforma de Messenger y quieran enviar mensajes promocionales fuera del intervalo de mensajes estándar de 24 horas deberán usar 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 una persona que envió un mensaje a tu página, envía una solicitud POST al punto de conexión /PAGE-ID/messages con la clave literal id del objeto recipient configurada en el identificador específico de la página de la persona (PSID), el parámetro message_type configurado en RESPONSE y el objeto text del parámetro message configurado 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 se envía correctamente, tu app recibirá la siguiente respuesta JSON con el identificador del destinatario y el identificador del mensaje.

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

Enviar contenido multimedia como adjunto

Para enviar un mensaje con contenido multimedia, como un GIF o imagen o una plantilla, debes agregar el contenido a la solicitud de la API como objeto de adjunto de mensaje JSON.

Para enviar un mensaje con una imagen a una persona que envió un mensaje a tu página, envía una solicitud POST al punto de conexión /PAGE-ID/messages con la clave literal id del objeto recipient configurada en el identificador específico de la página de la persona (PSID), el parámetro message_type configurado en RESPONSE y la clave type del objeto attachment del parámetro message configurada en image y la clave url del objeto payload configurada 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 se envía correctamente, tu app 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, video o un archivo desde una URL se usa el mismo formato.

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

Enviar varios archivos multimedia como adjuntos

Para enviar un mensaje con varias imágenes, debes agregar el contenido a la solicitud de la API como matriz de adjunto de mensaje JSON. El único tipo de contenido multimedia permitido es de imagen y se limita a 30 imágenes a la vez.

Para enviar un mensaje con varias imágenes a una persona que envió un mensaje a tu página, envía una solicitud POST al punto de conexión /PAGE-ID/messages, con la clave literal id del objeto recipient configurada en el identificador específico de la página de la persona (PSID), el parámetro message_type configurado en RESPONSE y el parámetro message contiene una matriz attachments donde cada clave type de objeto adjunto está configurada en image y la clave url del objeto payload está configurada 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 se envía correctamente, tu app recibirá la siguiente respuesta JSON con el identificador del destinatario y el identificador del mensaje.

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

Responder a un mensaje

Para escribir una respuesta a un mensaje previo del chat, envía una solicitud POST al punto de conexión /PAGE-ID/messages con lo siguiente:

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

El mensaje puede ser uno de tu página o uno que haya enviado 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 se envía correctamente, tu app 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é conciso. Ten en cuenta el tamaño de la pantalla y el comportamiento de desplazamiento. Las personas suelen responder más fácilmente a los mensajes breves. Envía varios mensajes separados en lugar de uno largo.
• No uses texto para sustituir imágenes, tablas, gráficas e imágenes. Para este propósito, los mensajes estructurados o incluso una vista web pueden ser una mejor opción.
• No escribas mensajes extensos. Si necesitas comunicar varias cosas, envía varios mensajes separados en lugar de uno extenso.

Archivos adjuntos

• Pon atención a la calidad. Utiliza imágenes de colores vivos y alta resolución para que tus mensajes se destaquen.
• Ten en cuenta la relación de aspecto. Revisa cómo podría recortarse tu imagen al aparecer en el cuadro de mensaje.
• No incluyas mucho texto en la imagen. En cambio, usa 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 a una persona autorización para enviar varios mensajes de marketing una vez transcurrido el intervalo estándar. Si la persona acepta la solicitud para recibir estas notificaciones, podrás enviarle mensajes promocionales periódicos automatizados con información sobre tus próximas ofertas o lanzamientos de productos y otras novedades.

Mensajes de noticias (en desarrollo)

Los mensajes de noticias solo están disponibles para editores de noticias registrados en el índice de páginas de noticias (NPI) de Facebook. Los mensajes de noticias permiten a los editores de noticias enviar mensajes de noticias no promocionales a las personas que se suscribieron para recibir estos mensajes.

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

Notificaciones únicas

Las notificaciones únicas te permiten pedir a una persona autorización para enviarle un mensaje de seguimiento una vez transcurrido el intervalo estándar. Si la persona acepta esta solicitud para recibir una notificación única, podrás enviarle un mensaje que sea relevante para la persona y el momento en que lo envías, como un recordatorio de cita o una alerta de productos en existencia.

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 una persona cuando esa persona publica un comentario en una de tus publicaciones o anuncios, o cuando publica en una publicación como visitante de tu página o tu cuenta profesional de Instagram. La respuesta privada permite el envío de un único mensaje, que incluirá automáticamente un enlace a la publicación o el comentario. Dicha respuesta debe enviarse en un plazo de siete días desde que la persona hizo la publicación o el comentario.

Mensajes publicitarios

Los mensajes publicitarios te permiten enviar contenido promocional o no promocional, después de que haya caducado el intervalo de mensajes estándar, a una persona que haya enviado previamente un mensaje a tu página o cuenta profesional de Instagram. Los mensajes publicitarios se ven como mensajes normales en la conversación, pero incluyen la palabra “publicidad” encima. El contenido de los mensajes publicitarios debe cumplir con las Políticas de publicidad.

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

Mensajes de utilidad

Los mensajes de utilidad te permiten enviar un mensaje de plantilla preaprobado que incluye pedidos, actualizaciones de cuentas y citas. Estos mensajes están muy personalizados e incluyen números de cuenta, identificadores de pedidos, números de seguimiento de envío y fechas y horas de citas. Además, pueden incluir llamadas a la acción que permitan al usuario cancelar un pedido, reprogramar una cita y hacer otras acciones que faciliten la interacción con un negocio.

Próximos pasos

Obtén información sobre los componentes que puedes agregar a los mensajes en tus conversaciones.

Más información

Obtén más información sobre cómo enviar mensajes mediante la plataforma de Messenger.

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