atendroZAP Documentação
DocsEnviar mensagens
Markdown
POST/send/media

Enviar mídia

URL depende da allowlist de mídia. PTT requer OGG/Opus; sem transcodificação outros formatos saem como áudio comum.

Autenticação

Header obrigatório: token. Use o token da instância.

Base URL: a API do servidor selecionado, como https://1.atendro.cloud. O domínio wpp.atendro.cloud hospeda a documentação e o console.

Idempotência: suporta Idempotency-Key, com retenção de 24 horas. Preserve a mesma chave, método, caminho e bytes do corpo ao repetir. Entenda a idempotência.

Headers adicionais

CampoTipoPresençaDescrição
X-Request-IdstringopcionalASCII visível sem espaços, 1–128 caracteres. Inválido/ausente é substituído por UUID. Ecoado na resposta. Comprimento máximo: 128
Idempotency-KeystringopcionalASCII visível sem espaços, 1–128. Repetir método, caminho e os mesmos bytes do JSON. 409 em andamento; 422 se mudar a requisição. 504 é guardado e não deve causar reenvio automático. Comprimento mínimo: 1. Comprimento máximo: 128

Corpo da requisição

Formato: application/json. Corpo obrigatório.

CampoTipoPresençaDescrição
numberstringobrigatórioDígitos com DDI (8–15) ou identificador @s.whatsapp.net, @g.us ou @lid. Nunca inferir telefone de um LID. Comprimento mínimo: 1
replyidstringopcionalID de mensagem guardada para citação; desconhecida retorna 422 reply_not_found.
delayinteger / stringopcionalEspera de digitação em milissegundos; o manager limita a 15000 ms.
forwardboolean / string / integer / nullopcional—
typestringobrigatórioValores: "image", "video", "audio", "ptt", "document", "sticker"
filestringobrigatórioData URI, base64 ou URL permitida por ATENDROZAP_MEDIA_URL_ALLOWLIST. Até 32 MiB decodificados; JSON até 48 MiB. Comprimento mínimo: 1
textstringopcionalLegenda em UTF-8, até 65536 bytes. Comprimento máximo: 65536
docNamestringopcionalNome-base do documento.

Respostas

Enviar mídia

CampoTipoPresençaDescrição
successbooleanobrigatórioValores: true
messageidstringobrigatório—
messageIdstringobrigatório—
idstringobrigatório—
timestampintegerobrigatórioUnix em segundos. Formato: int64
mimetypestringobrigatório—
pttbooleanobrigatório—
notestringopcionalExplica envio como áudio comum quando PTT não é possível.