> ## Documentation Index > Fetch the complete documentation index at: https://developers.datafyapi.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Enviar documento > Envie um PDF ou outro documento, com o nome do arquivo. Envia um documento, como PDF, planilha ou apresentação, para um cliente com a [janela de 24 horas](https://developers.datafyapi.com.br/api-reference/whatsapp/mensagens/introducao.md#janela-de-24-horas) aberta. > [!NOTE] > > O destinatário pode ser informado pelo **número de telefone** (`to`) ou pelo **ID do usuário** (`recipient`). Se os dois forem enviados, vale o `to`; para enviar pelo ID do usuário, deixe o `to` em branco. Veja a diferença em [Destinatário](https://developers.datafyapi.com.br/api-reference/whatsapp/mensagens/introducao.md#destinatário). ## Link ou ID da mídia Informe o documento de uma das duas formas: | Campo | Quando usar | Como conseguir | | - | - | - | | `document.link` | O documento está em uma URL pública. | Envie o arquivo na aba **Mídias** do número, no [painel da Datafy](https://app.datafyapi.com.br). O link gerado vale por **30 dias**. | | `document.id` | Você já enviou o arquivo para a Meta. | Use o `id` retornado pelo endpoint [Upload de mídia](https://developers.datafyapi.com.br/api-reference/whatsapp/recursos/midia/upload-de-midia.md). | > [!WARNING] > > **Envie apenas um dos dois.** Com `link` e `id` na mesma requisição, a Meta recusa o envio. No **Testar**, o `link` já vem preenchido com um PDF de exemplo. Para testar com um `id`, apague o `link` antes de enviar. ## Nome do arquivo Use `document.filename` para definir o nome que o cliente vê, **com a extensão**, como `boleto-pedido-7539.pdf`. O WhatsApp usa a extensão para mostrar o ícone do tipo de arquivo. ## Formatos aceitos | Tipo | Extensão | Tipo MIME | Tamanho máximo | | - | - | - | - | | PDF | `.pdf` | `application/pdf` | 100 MB | | Texto | `.txt` | `text/plain` | 100 MB | | Word | `.doc` / `.docx` | `application/msword` / `application/vnd.openxmlformats-officedocument.wordprocessingml.document` | 100 MB | | Excel | `.xls` / `.xlsx` | `application/vnd.ms-excel` / `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` | 100 MB | | PowerPoint | `.ppt` / `.pptx` | `application/vnd.ms-powerpoint` / `application/vnd.openxmlformats-officedocument.presentationml.presentation` | 100 MB | Só esses tipos são aceitos oficialmente pela Meta. Outros formatos podem não abrir corretamente no WhatsApp do cliente. A legenda aceita até **1.024 caracteres** e a mesma [formatação do texto](https://developers.datafyapi.com.br/api-reference/whatsapp/mensagens/enviar-texto.md#formatação). Veja mais detalhes na [documentação de mensagens de documento da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/document-messages). ## OpenAPI ````yaml api-reference/whatsapp/specs/documento.json POST /v1/{phone_number_id}/messages openapi: 3.1.0 info: title: Datafy API — Enviar documento version: 1.0.0 servers: - url: https://cloud.datafyapi.com.br description: Produção security: - bearerAuth: [] paths: /v1/{phone_number_id}/messages: post: summary: Enviar documento operationId: enviarDocumento parameters: - name: phone_number_id in: path required: true schema: type: string description: ID do número que envia a mensagem. Descubra com `GET /me`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MensagemDocumento' example: messaging_product: whatsapp recipient_type: individual to: '5511999999999' type: document document: link: >- https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf filename: boleto-pedido-7539.pdf caption: Segue o boleto do seu pedido. responses: '200': description: Envio aceito pela Meta. Não confirma a entrega. content: application/json: example: messaging_product: whatsapp contacts: - input: '5511999999999' wa_id: '5511999999999' messages: - id: wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA= '400': description: Erro retornado pela Meta, como enviar `id` e `link` juntos. content: application/json: example: error: message: >- (#132018) There’s an issue with the parameters in your template type: OAuthException code: 132018 error_data: messaging_product: whatsapp details: Only one of media ID or link must be present fbtrace_id: AbCdEfGhIjK '401': description: Token ausente ou inválido. content: application/json: example: statusCode: 401 message: Token inválido ou não encontrado. components: schemas: MensagemDocumento: type: object required: - messaging_product - to - type - document properties: messaging_product: type: string enum: - whatsapp default: whatsapp example: whatsapp description: Sempre `whatsapp`. recipient_type: type: string enum: - individual default: individual example: individual description: Sempre `individual`. to: type: string example: '5511999999999' description: >- Número do destinatário com código do país e DDD, como `5511999999999`. Tem prioridade sobre `recipient`: para enviar pelo ID do usuário, deixe em branco. recipient: type: string description: >- ID do usuário no WhatsApp (BSUID), recebido nos webhooks em `from_user_id` e `contacts[].user_id`, como `BR.13491208655302741918`. Usado quando `to` não é informado. type: type: string enum: - document default: document example: document description: Sempre `document`. document: type: object description: Documento da mensagem. Informe `link` **ou** `id`, nunca os dois. properties: link: type: string example: >- https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf description: >- URL pública do documento. Você pode gerar um link na aba **Mídias** do número, no painel da Datafy. Não envie junto com `id`. id: type: string description: >- ID da mídia retornado pelo endpoint **Upload de mídia**. Não envie junto com `link`. filename: type: string example: boleto-pedido-7539.pdf description: >- Nome do arquivo exibido para o cliente, com extensão. O WhatsApp usa a extensão para mostrar o ícone do tipo de arquivo. caption: type: string maxLength: 1024 example: Segue o boleto do seu pedido. description: Legenda exibida junto ao documento, com até 1.024 caracteres. context: type: object description: Responde citando uma mensagem anterior da conversa. properties: message_id: type: string description: ID (`wamid`) da mensagem que será citada. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Token gerado no painel da Datafy ao criar o canal. Formato: `sk_live_xxx`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.