Documento

📄 Mensagens de Documento

As mensagens de documento permitem que você envie arquivos como PDFs, documentos, planilhas e apresentações para os seus clientes.

Exemplo de mensagem de documento no WhatsApp

Limitações

Tamanho máximo do arquivo: 100MB

Formatos suportados: pdf, xls, xlsx, doc, docx, ppt, pptx e outros formatos comuns de documentos

Boas práticas

É recomendável sempre incluir o parâmetro filename para melhorar a experiência do usuário

Use legendas concisas e informativas para descrever o conteúdo do documento

Certifique-se de que o documento esteja em uma URL HTTPS pública e acessível

Verifique se o documento não excede o limite de tamanho de 100MB

Escolha formatos de arquivo amplamente suportados para garantir a compatibilidade

Casos de uso comuns

Envio de faturas e recibos

Compartilhamento de manuais e guias

Distribuição de relatórios e apresentações

Envio de formulários e documentos para assinatura

Compartilhamento de catálogos de produtos

Erros comuns

Código	Mensagem de erro	Solução
131055	Media upload error	Verifique se a URL é válida e acessível
131056	Media file too large	Reduza o tamanho do arquivo para menos de 100MB
131057	Media file format not supported	Use um formato de documento suportado

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/json

Exemplo

{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{recipient_number}}",
    "type": "document",
    "document": {
        "link": "https://example.com/documento.pdf",
        "caption": "Relatório mensal",
        "filename": "relatorio-mensal.pdf"
    }
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Respostas

🟢200OK

application/json

Documento enviado com sucesso

Body

Exemplo

{
    "messaging_product": "string",
    "contacts": [
        {
            "input": "string",
            "wa_id": "string"
        }
    ],
    "messages": [
        {
            "id": "string"
        }
    ]
}

🟠400Pedido inválido

🟠401Não autorizado

📄 Mensagens de Documento#

Limitações#

Boas práticas#

Casos de uso comuns#

Erros comuns#