Saltar al contenido principal
POST

Formatos y Límites de Tamaño

Requisitos de URL

La URL debe ser públicamente accesible vía HTTPS, no debe requerir autenticación, y debe apuntar directamente al archivo (no a una página HTML).

Errores Comunes

  • INVALID_MEDIA_URL - La URL de la imagen es inválida o inaccesible
  • MEDIA_TOO_LARGE - La imagen excede el límite de 5MB
  • UNSUPPORTED_MEDIA_TYPE - El formato de imagen no es soportado

Casos de Uso

  • Compartir fotos de productos
  • Enviar menús visuales
  • Mostrar instrucciones visuales
  • Compartir capturas de pantalla

Autorizaciones

Authorization
string
header
requerido

Basic authentication using Base64 encoded clientId:clientSecret

Parámetros de ruta

botId
string
requerido

The unique identifier of the bot

Cuerpo

application/json

Message payload. The structure varies based on the message type.

type
enum<string>
requerido

Type of message to send

Opciones disponibles:
text
Ejemplo:

"text"

userId
string
requerido

Unique identifier of the user receiving the message. Accepts either a phone number in E.164 format without the leading '+' (e.g. '593999999999') or a BSUID (Business-Scoped User ID, e.g. 'US.13491208655302741918') for users who have enabled phone number privacy in WhatsApp.

Ejemplo:

"593999999999"

text
string
requerido

Text content of the message

Ejemplo:

"Hello, this is a text message"

botId
string

Unique identifier of the bot sending the message

Ejemplo:

"BOT_ID"

Respuesta

Message sent successfully

success
boolean
Ejemplo:

true

messageId
string
Ejemplo:

"msg_123456789"