Skip to main content
POST
Envía un nuevo mensaje directo a un destinatario.
Precios y límites: cada User Profile puede tener hasta 1,000 conversaciones activas por ciclo de facturación en todas las redes sociales. El precio depende de tu plan: los planes Premium pagan un complemento fijo de 49almes,mientrasquelosplanesLaunchyBusinesssefacturana49 al mes**, mientras que los planes **Launch** y **Business** se facturan a **0.09 por conversación activa. Una conversación se cuenta como activa cuando envías un mensaje a un destinatario durante el ciclo de facturación; los mensajes entrantes por sí solos no cuentan. El número de mensajes dentro de una conversación activa es ilimitado.
  • Puedes enviar un emoji como parte del texto de message.
  • Los mediaUrls de Facebook e Instagram deben terminar con una extensión conocida. Incluir parámetros de consulta hará que la URL del contenido multimedia falle.
Ventana de atención al cliente de 24 horas en WhatsApp. WhatsApp Business solo permite el envío de mensajes salientes en formato libre dentro de las 24 horas posteriores al último mensaje del interlocutor. Fuera de esa ventana, Meta rechazará los envíos hasta que el interlocutor envíe otro mensaje. Los mensajes con plantilla fuera de la ventana de 24 horas no están soportados actualmente a través de este endpoint.

Parámetros de cabecera

Parámetros de ruta

string
requerido
La plataforma a la que enviar el mensaje: facebook, instagram, twitter, whatsapp

Parámetros del cuerpo

string
requerido
El ID del destinatario del mensaje.
  • Para Facebook, Instagram y X/Twitter es el ID de usuario específico de la plataforma (PSID, IGSID o user ID).
  • Para WhatsApp es el número de teléfono del destinatario en formato E.164 solo con dígitos (por ejemplo 14155551234, no +1 (415) 555-1234).
string
requerido
El mensaje que se va a enviar al destinatario.
  • En Facebook, Instagram y WhatsApp, message puede ser una cadena vacía u omitirse por completo cuando se proporciona mediaUrls.
  • X requiere un mensaje de al menos un carácter aunque se proporcione un mediaUrls.
array
Array de URLs de contenido multimedia para adjuntar imágenes, video, audio (incluidos mensajes de voz) o documentos.
  • Las URLs de los elementos multimedia deben terminar con la extensión del archivo, sin parámetros adicionales añadidos.
  • Facebook e Instagram admiten múltiples URLs de contenido multimedia.
  • X solo acepta una única URL de contenido multimedia.
  • Los mensajes de voz son compatibles en Facebook e Instagram como archivos aac o wav.
  • WhatsApp admite múltiples URLs de contenido multimedia. Ayrshare descarga cada URL y utiliza el Content-Type de su respuesta para elegir la categoría de medio de WhatsApp. Meta acepta:
    • Imagen: .jpg, .jpeg, .png
    • Video: .mp4, .3gp
    • Audio: .aac, .amr, .mp3, .m4a, .ogg
    • Documento: .txt, .pdf, .ppt, .pptx, .doc, .docx, .xls, .xlsx