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://example.com/image.png",
"caption": "Check out this image!",
"viewOnce": false
}
'{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}{
"error": 405,
"message": "Method not allowed"
}{
"error": 415,
"message": "Unsupported media type"
}Mensagens
Enviar imagem
Envie mensagens com imagens via 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://example.com/image.png",
"caption": "Check out this image!",
"viewOnce": false
}
'{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}{
"error": 405,
"message": "Method not allowed"
}{
"error": 415,
"message": "Unsupported media type"
}Conceituação
Método para envio de imagens. Você pode enviar a imagem de duas formas: por URL ou por Base64.Ao enviar em Base64, é obrigatório incluir o prefixo com o tipo da imagem, por exemplo:
data:image/png;base64,. Para validar, cole o Base64 completo na barra de endereço do navegador e verifique se a imagem renderiza corretamente.Os limites de tamanho e formatos suportados seguem as políticas do WhatsApp. Consulte a documentação oficial do WhatsApp para mais detalhes.
Autorizações
Secret Key generated in the Omni Z-API Security panel
Corpo
application/json
Recipient phone number (country code + area code + number)
Exemplo:
"5511999999999"
Image URL or Base64 data
Image caption
ID of an existing message to reply to
Delay in seconds before sending (1-15)
Intervalo obrigatório:
1 <= x <= 15Send as view-once message