Imagem

curl --request POST \
  --url https://api.jelou.ai/v1/bots/BOT_ID/messages \
  --header 'Authorization: Basic <Base64Encoded clientId:clientSecret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "image",
    "mediaUrl": "https://example.com/image.jpg",
    "text": "Check out this image",
    "userId": "USER_ID"
  }'

{
  "success": true,
  "messageId": "msg_123456789"
}

POST

bots

{botId}

messages

curl --request POST \
  --url https://api.jelou.ai/v1/bots/BOT_ID/messages \
  --header 'Authorization: Basic <Base64Encoded clientId:clientSecret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "image",
    "mediaUrl": "https://example.com/image.jpg",
    "text": "Check out this image",
    "userId": "USER_ID"
  }'

{
  "success": true,
  "messageId": "msg_123456789"
}

curl --request POST \
  --url https://api.jelou.ai/v1/bots/BOT_ID/messages \
  --header 'Authorization: Basic <Base64Encoded clientId:clientSecret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "image",
    "mediaUrl": "https://example.com/image.jpg",
    "text": "Check out this image",
    "userId": "USER_ID"
  }'

{
  "success": true,
  "messageId": "msg_123456789"
}

Parâmetros de rota

string

obrigatório

Identificador único do bot que envia a mensagem.

Parâmetros do corpo

string

obrigatório

Tipo de mensagem. Deve ser "image".

string

obrigatório

Destinatário da mensagem. Aceita um número de telefone no formato E.164 sem o sinal + (ex.: 593999999999) ou um BSUID (ex.: US.13491208655302741918) para usuários com a proteção de número ativada no WhatsApp. Veja Identificação do destinatário.

string

obrigatório

URL pública (HTTPS) do arquivo de imagem. Os formatos e o tamanho máximo dependem do canal (veja a tabela de formatos e limites por canal).

string

Texto opcional exibido junto com a mídia. Apenas WhatsApp: Instagram e Messenger não suportam texto junto com a imagem; para enviá-lo, use uma mensagem de texto separada.

Resposta

boolean

true se a mensagem foi enviada com sucesso.

string

Identificador da mensagem enviada.

Formatos e limites de tamanho por canal

Canal	Formatos suportados	Limite de tamanho
WhatsApp	`image/jpeg`, `image/png`	5MB
Instagram	`image/jpeg`, `image/png`	8MB
Messenger	`image/jpeg`, `image/png`	8MB

Requisitos de URL

A URL deve ser acessível publicamente via HTTPS, não deve exigir autenticação e deve apontar diretamente para o arquivo (e não para uma página HTML).

Erros Comuns

INVALID_MEDIA_URL - A URL da imagem é inválida ou inacessível
MEDIA_TOO_LARGE - A imagem excede o limite de tamanho do canal
UNSUPPORTED_MEDIA_TYPE - O formato da imagem não é suportado

Casos de Uso

Compartilhar fotos de produtos
Enviar menus visuais
Mostrar instruções visuais
Compartilhar capturas de tela

Referência de API

Enviar Mensagens

Campanhas

Conversações

Etiquetas

Métricas

Usuários

Recursos

Widget

Datum

Painel de Atendimento Externo

Canal Personalizado

Gestão de Memória

Parâmetros de rota

Parâmetros do corpo

Resposta

Formatos e limites de tamanho por canal

Requisitos de URL

Erros Comuns

Casos de Uso

​Parâmetros de rota

​Parâmetros do corpo

​Resposta

​Formatos e limites de tamanho por canal

​Requisitos de URL

​Erros Comuns

​Casos de Uso

Parâmetros de rota

Parâmetros do corpo

Resposta

Formatos e limites de tamanho por canal

Requisitos de URL

Erros Comuns

Casos de Uso