Pular para o conteúdo

Enviar mensagens

Enviar figurinha

Envie uma figurinha (sticker) WebP, estática ou animada, por WhatsApp.

Envie uma figurinha em POST /v1/messages com type: "sticker". Só o WhatsApp aceita esse tipo. Os campos comuns a todos os tipos (to, reply_to, typing, delay_ms, janela de 24 h) estão em Campos comuns.

Janela do terminal
curl -X POST https://api.messajo.com/v1/messages \
-H "Authorization: Bearer $MESSAJO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"connection_id": "con_123",
"to": "5511999990000",
"type": "sticker",
"sticker": {
"link": "https://cdn.exemplo.com/joia.webp"
}
}'

A resposta é 201 com id (msg_…), status: "queued" e conversation_id. O estado final chega por webhook.

Informe exatamente um entre link e media_id. Mandar os dois, ou nenhum, devolve 400 validation_failed com exactly one of media_id or link is required. Figurinha não tem legenda.

  • link: URL do arquivo .webp.
  • media_id (med_…): vem de POST /v1/media, um multipart/form-data com file (e connection_id, exceto com chave de conexão mjc_…). Exige a permissão send. O tipo é lido dos bytes do arquivo, não da extensão.
Janela do terminal
curl -X POST https://api.messajo.com/v1/media \
-H "Authorization: Bearer $MESSAJO_API_KEY" \
-F connection_id=con_123 \
-F file=@joia.webp

O upload devolve o id da mídia (med_…), que você usa em sticker.media_id.

Só WebP. O upload detecta no arquivo se a figurinha é animada:

Tipo Tamanho máximo
Estática 100 KiB
Animada 500 KiB

Acima do limite, o upload devolve 413 media_too_large.

Não aceitam figurinha: type: "sticker" devolve 422 type_not_supported_by_channel.

Código Status Quando
validation_failed 400 link e media_id juntos, ou nenhum dos dois
media_too_large 413 Acima de 100 KiB (estática) ou 500 KiB (animada)
media_type_not_supported 415 Arquivo que não é WebP
media_error 422 A Meta não conseguiu processar a mídia
type_not_supported_by_channel 422 Instagram ou Messenger
outside_service_window 422 Mensagem livre fora da janela de 24 h