POST
/
messages
/
media
Enviar mensagem de mídia
curl --request POST \
  --url https://api.zapperapi.com/{instanceId}/messages/media \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '{
  "jid": "<string>",
  "mediaType": "image",
  "mimetype": "<string>",
  "media": "<string>",
  "caption": "<string>",
  "filename": "<string>",
  "videoNote": true,
  "mentions": [
    "<string>"
  ],
  "mentionsEveryone": true,
  "expiration": "none"
}'

Authorizations

​
X-Api-Key
string
header
required

Chave privada da API

Body

application/json
​
jid
string
required

Número de telefone, LID ou id do grupo. Em caso de número de telefone, o mesmo deve ser enviado no formato completo, com código do país, e o prefixo + não é obrigatório. Números de telefone podem ser ou não pós-fixados com @s.whatsapp.net. Em caso de grupo, o id deve ser enviado acrescido de @g.us.

Exemplos de uso correto:

  +5511912345678

  5511912345678

  5511912345678@s.whatsapp.net

  12345678-987654321@g.us


  Em caso de LID, que é um código interno do WhatsApp utilizado para proteger
  a privacidade dos usuários e não exibir o número do telefone, o mesmo deve
  ser enviado no formato completo, com o sufixo `@lid`.
Minimum length: 1
​
mediaType
enum<string>
required

Tipo de mídia a ser enviada.

Available options:
image,
video,
audio,
document
​
media
string
required

Mídia a ser encaminhada. Pode ser utilizado uma URL (http/https), arquivo no formato base64 ou uma URL base64.

​
mimetype
string

Mimetype do arquivo enviado (ex: image/png). Aplicável somente para o tipo de mídia document

​
caption
string

Legenda da mídia. Não se aplica ao tipo de mídia audio e ao tipo de mídia video quando videoNote está ativo

​
filename
string

Nome do arquivo. Aplicável somente para mídias do tipo document

​
videoNote

Enviar vídeo como nota (em um círculo)

​
mentions
string[]

Lista de números que deseja mencionar na mensagem. Campo opcional e só tem efeito em envio de mensagens para grupos

Id do contato (número ou lid). Para números de telefone, pode ser enviado com ou sem o sufixo @s.whatsapp.net. Para lids, sempre use o sufixo @lid

​
mentionsEveryone

Indica se deseja mencionar todos os participantes do grupo. Use com cautela. Caso esta opção esteja ativa, o parâmetro mentions será ignorado.

​
expiration
enum<string>

Tempo de desaparecimento da mensagem, podendo ser desligado (padrão), 24 horas, 7 dias ou 90 dias.

Available options:
none,
24h,
7d,
90d

Response

200

Default Response