1. Mensagens
DBX Tech
  • Hub DBX
    • Como enviar mensagens
    • Mensagens
      • Áudio
        POST
      • Contato
        POST
      • Documento
        POST
      • Imagem
        POST
      • Interativa com chamada para ação (URL)
        POST
      • Interativa com lista
        POST
      • Interativa com botões
        POST
      • Localização
        POST
      • Figurinha
        POST
      • Texto
        POST
      • Vídeo
        POST
      • Reação
        POST
      • Confirmação de leitura
        POST
    • Modelos de mensagens
      • Texto
      • Imagem
      • Documento
      • Vídeo
      • Botões
      • Lista
      • Localização
      • Código OTP
    • Mídia
      • Obter mídia
    • Esquemas
      • Responses and Errors
        • MessageResponse
        • BaseMessage
        • ErrorResponse
      • Mensagens
        • Áudio
        • Contato
        • Documento
        • Imagem
        • Interativa com chamada para ação (URL)
        • Interativa com lista
        • Interativa com botões
        • Localização
        • Figurinha
        • Texto
        • Vídeo
        • Reação
        • Confirmação de leitura
      • Modelos
        • HeaderTextComponent
        • TemplateLanguage
        • TextParameter
        • ImageParameter
        • DocumentParameter
        • VideoParameter
        • LocationParameter
        • ButtonParameter
        • HeaderMediaComponent
        • BodyComponent
        • ButtonComponent
        • FooterComponent
        • TextTemplate
        • MediaTemplate
        • InteractiveTemplate
        • LocationTemplate
        • OTPTemplate
        • TextTemplateMessage
        • MediaTemplateMessage
        • InteractiveTemplateMessage
        • LocationTemplateMessage
        • OTPTemplateMessage
  • Chat DBX
    • send message to bot
      GET
  1. Mensagens

Documento

POST
https://waba.optjuntos.com.br/api/v1/messages

📄 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ódigoMensagem de erroSolução
131055Media upload errorVerifique se a URL é válida e acessível
131056Media file too largeReduza o tamanho do arquivo para menos de 100MB
131057Media file format not supportedUse um formato de documento suportado

Requisição

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"
    }
}

Códigos de solicitação

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://waba.optjuntos.com.br/api/v1/messages' \
--header 'Content-Type: application/json' \
--data '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "5517991677564",
    "type": "document",
    "document": {
        "link": "https://example.com/documento.pdf",
        "caption": "Relatório mensal",
        "filename": "relatorio-mensal.pdf"
    }
}'

Respostas

🟢200OK
application/json
Documento enviado com sucesso
Bodyapplication/json

Exemplo
{
    "messaging_product": "string",
    "contacts": [
        {
            "input": "string",
            "wa_id": "string"
        }
    ],
    "messages": [
        {
            "id": "string"
        }
    ]
}
🟠400Pedido inválido
🟠401Não autorizado
Modificado em 2025-04-08 06:51:37
Página anterior
Contato
Próxima página
Imagem
Built with