Resumen

Cuando envía un archivo a través de una sesión activa de WhatsApp usando la API de Wati, el nombre del archivo adjunto puede aparecer como null o untitled si no incluye el parámetro caption en su solicitud.

Para solucionar esto, incluya el parámetro caption como parámetro de consulta y asígnele el nombre de archivo que desea mostrar. Este artículo explica cómo aplicar esta solución usando la API heredada v1 y proporciona orientación para la API v3 recomendada.

Instrucciones

1. Corregir el nombre del archivo adjunto

El parámetro caption especifica el nombre que se muestra para el archivo adjunto. Si omite este parámetro, el nombre del archivo adjunto puede aparecer como null o untitled.

Para mostrar el nombre de archivo correcto, incluya caption en su solicitud de API como un parámetro de consulta.

Importante: Pase el caption en la cadena de consulta (query string), no en el cuerpo de la solicitud. Envíe el archivo como un campo de formulario multipart llamado file.

2. Corregir el problema usando la API heredada v1

Puede utilizar el endpoint de la versión heredada v1 para enviar un archivo durante una sesión activa de WhatsApp.

Endpoint:

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

Parámetros de la API

Parámetro	Tipo	Ubicación	Descripción
`tenantId`	String	Path	Su ID de inquilino (tenant ID) de Wati.
`target`	String	Path	El número de teléfono del destinatario, ID de contacto o ID de usuario con ámbito empresarial (BSUID).
`caption`	String	Parámetro de consulta	El nombre del archivo que se mostrará para el adjunto.
`file`	Archivo	Cuerpo de solicitud multipart	El archivo que desea enviar. Utilice `file` como el nombre del campo del formulario.

Ejemplo de solicitud

El siguiente ejemplo envía un archivo llamado Invoice_October.pdf y utiliza ese nombre como el título (caption) del adjunto.

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

Reemplace los siguientes marcadores de posición con sus valores reales:

{tenantId} — Su ID de inquilino (tenant ID) de Wati.
85264318722 — El número de teléfono del destinatario.
<Token> — Su token de acceso a la API de Wati.
/path/to/Invoice_October.pdf — La ruta al archivo que desea cargar.

Puede cambiar Invoice_October.pdf por el nombre de adjunto que desee mostrar.

3. Utilice la API v3 recomendada

Para nuevas integraciones, utilice la API v3 cuando sea posible.

Endpoint:

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

A diferencia de los endpoints heredados v1, las rutas de los endpoints v3 no incluyen /{tenantId}/.

Cree un token de API con ámbito en su cuenta de Wati en Connector > API > Create API Token.

El campo target también admite el formato Channel:PhoneNumber.

Consulte la documentación para desarrolladores de Wati para conocer los parámetros requeridos y el formato de solicitud del endpoint v3.

4. Notas importantes

Incluya el caption: Pase el parámetro caption como un parámetro de consulta para especificar el nombre del archivo adjunto.
Utilice el campo de archivo correcto: Cargue el archivo como un campo de formulario multipart llamado file.
Verifique la respuesta de la API correctamente: Una respuesta HTTP 200 significa que la solicitud fue aceptada; no confirma que el archivo se haya entregado al destinatario.
Realice un seguimiento de la entrega: Utilice el evento webhook sentMessageDELIVERED_v2 para confirmar la entrega del mensaje.

Seguir estas pautas ayuda a evitar que los nombres de los archivos adjuntos aparezcan como null o untitled al enviar archivos a través de la API de Wati.

Cómo solucionar que los nombres de los archivos adjuntos aparezcan como null o sin título