curl --request POST \
--url https://api.omni.z-api.io/channels/{channel_id}/token/{channel_token}/send-image \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511999999999",
"image": "https://ejemplo.com/imagen.png",
"caption": "¡Mira esta imagen!",
"viewOnce": false
}
'
{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}{
"error": 405,
"message": "Method not allowed"
}{
"error": 415,
"message": "Unsupported media type"
}Mensajes
Enviar imagen
Envía mensajes con imágenes por WhatsApp
POST
/
send-image
curl --request POST \
--url https://api.omni.z-api.io/channels/{channel_id}/token/{channel_token}/send-image \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511999999999",
"image": "https://ejemplo.com/imagen.png",
"caption": "¡Mira esta imagen!",
"viewOnce": false
}
'
{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}{
"error": 405,
"message": "Method not allowed"
}{
"error": 415,
"message": "Unsupported media type"
}Conceptos
Método para enviar imágenes. Puedes enviar la imagen de dos formas: mediante URL o mediante Base64.Al enviarla en Base64 es obligatorio incluir el prefijo con el tipo de imagen, por ejemplo:
data:image/png;base64,. Para validarlo, pega el Base64 completo en la barra de direcciones del navegador y comprueba que la imagen se muestra correctamente.Los límites de tamaño y los formatos admitidos siguen las políticas de WhatsApp. Consulta la documentación oficial de WhatsApp para más detalles.
Autorizaciones
Secret Key generada en el panel de Seguridad de Omni Z-API
Cuerpo
application/json
Teléfono del destinatario (código de país + prefijo + número)
Ejemplo:
"5511999999999"
URL de la imagen o datos en Base64
Pie de la imagen
ID de un mensaje existente al que se quiere responder
Retardo en segundos antes del envío (1-15)
Rango requerido:
1 <= x <= 15Enviar como mensaje de visualización única