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 para el 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 que 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 con el identificador específico de la página de la persona (PSID), el parámetro message_type configurado como RESPONSE y el objeto text del parámetro message configurado como 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/v21.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 con el identificador específico de la página de la persona (PSID), el parámetro message_type configurado como RESPONSE y la clave type del objeto attachment del parámetro message configurada como image y la clave url del objeto payload configurada como 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/v21.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.

Prácticas recomendadas

Mensajes de texto

Archivos adjuntos

Más tipos de mensaje

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 de Facebook (NPI). Con esta herramienta, los editores de noticias pueden enviar mensajes de noticias no promocionales a las personas que se suscribieron para recibirlos.

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 en 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 de marketing

Los mensajes de marketing te permiten solicitar a una persona autorización para enviar varios mensajes de marketing después de que finaliza el intervalo estándar. Si la persona acepta esta solicitud para recibir estos mensajes, podrás enviarle mensajes promocionales periódicos automatizados con información sobre tus próximas ofertas o lanzamientos de productos y otras novedades.

Mensajes publicitarios

Los mensajes publicitarios te permiten enviar contenido promocional o no promocional después de finalizado el intervalo estándar a una persona que haya enviado un mensaje a tu página o tu 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.

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 usando 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.