Resumo

Ao enviar um arquivo através de uma sessão ativa do WhatsApp usando a API do Wati, o nome do anexo pode aparecer como null ou untitled se você não incluir o parâmetro caption em sua requisição.

Para corrigir isso, inclua o parâmetro caption como um parâmetro de consulta e defina-o com o nome do arquivo que você deseja exibir. Este artigo explica como aplicar essa correção usando a API v1 legada e fornece orientações para a API v3 recomendada.

Instruções

1. Corrija o nome do anexo

O parâmetro caption especifica o nome exibido para o anexo de arquivo. Se você omitir este parâmetro, o nome do anexo pode aparecer como null ou untitled.

Para exibir o nome correto do arquivo, inclua caption em sua requisição de API como um parâmetro de consulta.

Importante: Passe o caption na query string, não no corpo da requisição. Envie o arquivo propriamente dito como um campo de formulário multipart chamado file.

2. Corrija o problema usando a API v1 legada

Você pode usar o endpoint da v1 legada para enviar um arquivo durante uma sessão ativa do WhatsApp.

Endpoint:

POST https://live-mt-server.wati.io/{tenantId}/api/v1/sendSessionFile/{target}

Parâmetros da API

Parâmetro	Tipo	Localização	Descrição
`tenantId`	String	Path (Caminho)	Seu ID de tenant do Wati.
`target`	String	Path (Caminho)	O número de telefone do destinatário, ID do contato ou ID de usuário com escopo comercial (BSUID).
`caption`	String	Parâmetro de consulta	O nome do arquivo a ser exibido para o anexo.
`file`	Arquivo	Corpo da requisição multipart	O arquivo que você deseja enviar. Use `file` como o nome do campo do formulário.

Exemplo de requisição

O exemplo a seguir envia um arquivo chamado Invoice_October.pdf e usa esse nome como a legenda (caption) do anexo.

curl --location 'https://live-mt-server.wati.io/{tenantId}/api/v1/sendSessionFile/85264318722?caption=Invoice_October.pdf' \
--header 'Authorization: Bearer <Token>' \
--form 'file=@"/path/to/Invoice_October.pdf"'

Substitua os seguintes placeholders pelos seus valores reais:

{tenantId} — Seu ID de tenant do Wati.
85264318722 — O número de telefone do destinatário.
<Token> — Seu token de acesso à API do Wati.
/path/to/Invoice_October.pdf — O caminho para o arquivo que você deseja enviar.

Você pode alterar Invoice_October.pdf para o nome do anexo que deseja exibir.

3. Use a API v3 recomendada

Para novas integrações, use a API v3 onde for suportado.

Endpoint:

POST https://live-mt-server.wati.io/api/ext/v3/conversations/messages/file

Ao contrário dos endpoints da v1 legada, os caminhos dos endpoints da v3 não incluem /{tenantId}/.

Crie um token de API com escopo na sua conta Wati em Connector > API > Create API Token.

O campo target também suporta o formato Channel:PhoneNumber.

Consulte a documentação para desenvolvedores do Wati para obter os parâmetros necessários e o formato de requisição do endpoint da v3.

4. Notas importantes

Inclua a legenda (caption): Passe o parâmetro caption como um parâmetro de consulta para especificar o nome do anexo.
Use o campo de arquivo correto: Envie o arquivo como um campo de formulário multipart chamado file.
Verifique a resposta da API corretamente: Uma resposta HTTP 200 significa que a requisição foi aceita; isso não confirma que o arquivo foi entregue ao destinatário.
Acompanhe a entrega: Use o evento de webhook sentMessageDELIVERED_v2 para confirmar a entrega da mensagem.

Seguir estas diretrizes ajuda a evitar que os nomes dos anexos de arquivo apareçam como null ou untitled ao enviar arquivos através da API do Wati.

Como corrigir nomes de arquivos anexados que aparecem como null ou untitled