Enviar Archivos en Mensaje
Message
Enviar Archivo por Mensaje
Servicio para enviar archivos adjuntos en un mensaje de WhatsApp al contacto.
POST
Enviar Archivos en Mensaje
Descripcion
Envia un archivo multimedia (imagen, audio, video o documento) a un contacto por WhatsApp. El archivo puede enviarse de dos formas:- Por URL (
contentUrl): Proporciona una URL publica del archivo. El servidor descarga el archivo, lo sube a almacenamiento y lo envia al contacto. - Por archivo (
contentFile): Sube directamente el archivo comomultipart/form-data.
Si usas Workers, puedes enviar archivos multimedia usando
plz.whatsapp.sendMedia() que internamente utiliza este endpoint con contentUrl.Parametros
| Parametro | Tipo | Requerido | Descripcion |
|---|---|---|---|
workspaceId | string | Si | ID del workspace |
recipientPhone | string | Si | Numero de telefono del destinatario (con codigo de pais) |
contactId | string | Si | ID del contacto en la plataforma |
contentUrl | string | Condicional | URL publica del archivo a enviar. Requerido si no se envia contentFile |
contentFile | file | Condicional | Archivo binario. Requerido si no se envia contentUrl |
content | string | No | Caption o texto que acompana al archivo |
externalReferenceId | string | No | Identificador externo opcional para rastreo |
Tipos de archivo soportados
Imagenes
image/jpeg,image/png
Audio
audio/aac,audio/amr,audio/mpeg,audio/mp4,audio/ogg,audio/webm,audio/x-m4a- Los audios se convierten automaticamente a MP3
Video
video/mp4,video/3gpp
Documentos
application/pdf,application/msword,application/vnd.openxmlformats-officedocument.*- Y cualquier otro tipo de archivo se envia como documento
Ejemplo con URL
Ejemplo con archivo
Uso desde Workers
El servidor detecta automaticamente el tipo de archivo basandose en la extension de la URL. Si el archivo es un audio, se convierte automaticamente a formato MP3 para compatibilidad con WhatsApp.
Authorizations
Token de autenticacion Bearer. Obtenga el token usando el endpoint /api/user/login
Headers
Identificador del workspace
Query Parameters
ID del contacto
Identificador del workspace
Numero de WhatsApp del destinatario
Body
multipart/form-data
Archivo a enviar
Response
Archivo enviado exitosamente

