Necesitar\u00e1s tres cosas:<\/p>\n\n
- \n
- Un identificador de WhatsApp Business<\/li>\n\n\n\n
- Un identificador de n\u00famero de tel\u00e9fono o identificador de tel\u00e9fono de prueba<\/li>\n\n\n\n
- Tu token de usuario del sistema con los siguientes permisos requeridos:<\/li>\n<\/ul>\n\n
(whatsapp_business_management, whatsapp_business_messaging y business_management)<\/p>\n\n
Si ya quieres ver la aplicaci\u00f3n final, puedes consultar el c\u00f3digo final del proyecto<\/a>.<\/p>\n\n
Crear una aplicaci\u00f3n b\u00e1sica<\/h4>\n\n
Para esta demostraci\u00f3n, usar\u00e1s este servidor esqueleto b\u00e1sico Node.js y Express.js junto con las dependencias necesarias y las funciones esqueleto ya creadas.<\/p>\n\n
El tutorial tambi\u00e9n incluye el paquete Request<\/u><\/a> para llevar a cabo solicitudes HTTP cuando la aplicaci\u00f3n se comunique con una API. Hay dos variables en el archivo .env de la aplicaci\u00f3n:<\/p>\n\n
META_AUTH_TOKEN y MESSAGING_PRODUCT<\/p>\n\n
![\"Explorer](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/image1.png\")
<\/figure>\n\nTras configurar el servidor, puedes empezar a crear la API.<\/p>\n\n
Sube una imagen para el mensaje multimedia<\/h4>\n\n
Antes de poder enviar mensajes basados en archivos multimedia por WhatsApp, debes subir el archivo al que WhatsApp acceder\u00e1 m\u00e1s adelante. Los archivos multimedia subidos a WhatsApp est\u00e1n disponibles durante 30 d\u00edas a menos que los elimines.<\/p>\n\n
Debes crear una nueva ruta POST en el archivo routes\/media.js que puedes usar para administrar tu archivo multimedia. De acuerdo con la documentaci\u00f3n<\/u><\/a>, debes pasar cuatro elementos:<\/p>\n\n
- \n
- El identificador del n\u00famero de tel\u00e9fono, que pasas como par\u00e1metro.<\/li>\n\n\n\n
- El archivo que quieres subir, que pasas como dato de formulario.<\/li>\n\n\n\n
- Tipo de archivo subido, que generas con la funci\u00f3n auxiliar.<\/li>\n\n\n\n
- Producto de mensajes, que obtienes del archivo .env.<\/li>\n<\/ul>\n\n
Sin embargo, solo necesitas el identificador del n\u00famero de tel\u00e9fono y el archivo cuando creas una llamada API. Los campos restantes los generas con funciones auxiliares.<\/p>\n\n
Usas el paquete npm Formidable<\/u><\/a> para procesar los datos de formularios. Ten en cuenta que la API de WhatsApp Business tiene algunas limitaciones de tipos y tama\u00f1os espec\u00edficos. Puedes consultarlas en la secci\u00f3n de tipos de archivos multimedia admitidos al final de la documentaci\u00f3n de medios<\/u><\/a>. Tambi\u00e9n hay dos funciones auxiliares en el archivo helper\/validations.js del proyecto esqueleto para lidiar con esto.<\/p>\n\n
Para subir una imagen tienes que iniciar un nuevo formulario Formidable. Con el objeto Form, analiza el archivo y realiza las validaciones con las funciones auxiliares. Luego, realiza una solicitud POST con los datos del formulario y agrega un token de autenticaci\u00f3n v\u00e1lido usando la solicitud.<\/p>\n\n
exports.uploadMedia = async (req, res) => { let form = new formidable.IncomingForm(); form.keepExtensions = true; form.parse(req, async (err, fields, files) => { if (err) { return res.status(400).json({ error: \"No se pudo subir el contenido multimedia\", }); } if (!files.file) { return res.status(400).json({ error: \"Se requiere un archivo multimedia\", }); } let isFileValidSize = validateMediaSize(files.file.size, files.file.type); if (!isFileValidSize) { return res.status(400).json({ error: `El tama\u00f1o del archivo multimedia debe ser inferior a ${mediaLimits( files.file.type )}`, }); } request.post( { url: `https:\/\/graph.facebook.com\/v13.0\/${req.params.id}\/media`, formData: { file: { value: fs.createReadStream(files.file.path), options: { filename: files.file.name, contentType: files.file.type, }, }, type: files.file.type, messaging_product: process.env.MESSAGING_PRODUCT, }, headers: { Authorization: `Bearer ${process.env.META_AUTH_TOKEN}`, \"content-type\": \"multipart\/form-data\", }, }, function (err, resp, body) { if (err) { console.log(\"Error!\"); } else { res.json(JSON.parse(body)); } } ); }); };<\/code><\/pre>\n\nTras agregar esta funci\u00f3n, puedes probar la ruta con Postman. As\u00ed se deber\u00eda ver el objeto final en la interfaz de Postman:<\/p>\n\n
![\"Imagen](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/image3.png\")
<\/figure>\n\nCuando haces clic en Send<\/b>, deber\u00edas obtener el identificador del archivo multimedia subido como respuesta de la API.<\/p>\n\n
![\"Imagen](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/image5.png\")
<\/figure>\n\nToma nota del identificador del archivo multimedia subido, ya que lo usaremos m\u00e1s adelante. Si tu aplicaci\u00f3n tendr\u00e1 una capa de datos, puedes guardar este identificador en la base de datos para usarlo despu\u00e9s. O bien, tu aplicaci\u00f3n frontend puede almacenar el identificador temporalmente en las variables o el estado.<\/p>\n\n
Enviar un mensaje multimedia<\/h4>\n\n
Ahora, usa el identificador del archivo multimedia que obtuviste en el paso anterior para enviar un mensaje multimedia al cliente. De acuerdo con la referencia de la API<\/u><\/a>, debes enviar cinco elementos a la API para enviar el mensaje multimedia al cliente correctamente:<\/p>\n\n
- \n
- Identificador del n\u00famero de tel\u00e9fono pasado como par\u00e1metro<\/li>\n\n\n\n
- N\u00famero de tel\u00e9fono del cliente enviado en el cuerpo de la solicitud<\/li>\n\n\n\n
- Tipo de archivo multimedia enviado en el cuerpo de la solicitud<\/li>\n\n\n\n
- Identificador del archivo multimedia enviado en el cuerpo de la solicitud<\/li>\n\n\n\n
- Tipo de destinatario, \u00abIndividual\u00bb en este caso<\/li>\n<\/ul>\n\n
La funci\u00f3n se ve as\u00ed:<\/p>\n\n
exports.sendMediaMessage = async (req, res) => { const { id, to, type } = req.body; if (!id || !to || !type) { return res.status(400).json({ error: \"Campos obligatorios: to, type and id\", }); } request.post( { url: `https:\/\/graph.facebook.com\/v13.0\/${req.params.id}\/messages`, headers: { Authorization: `Bearer ${process.env.META_AUTH_TOKEN}`, \"content-type\": \"application\/json\", }, body: `{ \"messaging_product\": \"whatsapp\", \"recipient_type\": \"individual\", \"to\": \"${to}\", \"type\": \"${type}\", \"${type}\": { \"id\": \"${id}\", }, }`, }, function (err, resp, body) { if (err) { console.log(\"Error!\"); } else { res.json(JSON.parse(body)); } } ); };<\/code><\/pre>\n\nSi ejecutas este punto de conexi\u00f3n en Postman con los detalles y los argumentos necesarios, se ve as\u00ed:<\/p>\n\n
![\"Imagen](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/image6.png\")
<\/figure>\n\nDespu\u00e9s de enviarlo, ves la siguiente salida en Postman, que incluye tambi\u00e9n el identificador del mensaje.<\/p>\n\n
![\"Imagen](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/image7.png\")
<\/figure>\n\nVer elementos multimedia<\/h4>\n\n
Obtener la URL del archivo multimedia puede hacerse f\u00e1cilmente con la operaci\u00f3n GET y el identificador del archivo recuperado o almacenado.<\/p>\n\n
exports.getMediaUrl = async (req, res) => { request.get( { url: `https:\/\/graph.facebook.com\/v13.0\/${req.params.id}`, headers: { Authorization: `Bearer ${process.env.META_AUTH_TOKEN}`, }, }, function (err, resp, body) { if (err) { console.log(\"Error!\"); } else { res.json(JSON.parse(body)); } } ); };<\/code><\/pre>\n\nAs\u00ed se ve la solicitud y la respuesta en Postman tras obtener el elemento multimedia correctamente.<\/p>\n\n
![\"Imagen](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/image4.png\")
<\/figure>\n\nEliminar archivos multimedia<\/h4>\n\n
Para eliminar archivos multimedia, usar\u00e1s el mismo punto de conexi\u00f3n de la API de WhatsApp para solicitudes de archivos multimedia, pero con la operaci\u00f3n DELETE.<\/p>\n\n
exports.deleteMedia = async (req, res) => { request.delete( { url: `https:\/\/graph.facebook.com\/v13.0\/${req.params.id}`, headers: { Authorization: `Bearer ${process.env.META_AUTH_TOKEN}`, }, }, function (err, resp, body) { if (err) { console.log(\"Error!\"); } else { res.json(JSON.parse(body)); } } ); };<\/code><\/pre>\n\nTras eliminar el archivo multimedia correctamente, la API env\u00eda la siguiente respuesta:<\/p>\n\n
![\"Imagen](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/image2.png\")
<\/figure>\n\nObt\u00e9n m\u00e1s informaci\u00f3n sobre la Plataforma de WhatsApp Business<\/h4>\n\n
Este tutorial es tan solo un ejemplo de lo que puedes hacer con la Plataforma de WhatsApp Business. Cuando planifiques tu pr\u00f3ximo proyecto, consulta la documentaci\u00f3n de la Plataforma de WhatsApp Business<\/u><\/a> para conocer en detalle sus funcionalidades y limitaciones respecto a archivos multimedia.<\/p>\n\n
Aseg\u00farate de tener en cuenta lo siguiente:<\/p>\n\n
- \n
- Los archivos multimedia subidos solo est\u00e1n disponibles durante 30 d\u00edas<\/li>\n\n\n\n
- Las URL de descarga generadas solo est\u00e1n disponibles durante cinco minutos<\/li>\n\n\n\n
- Siempre guarda el identificador del archivo multimedia cuando lo subas<\/li>\n<\/ul>\n\n
La siguiente es una lista de los tipos de archivos multimedia que se admiten actualmente. Consulta los tipos de archivos multimedia admitidos<\/u><\/a> para obtener m\u00e1s informaci\u00f3n.<\/p>\n\n
- \n
- Audio (<16 MB) \u2013 ACC, MP4, MPEG, AMR y OGG<\/li>\n\n\n\n
- Documentos (<100 MB) \u2013 texto, PDF, Office y Open Office<\/li>\n\n\n\n
- Im\u00e1genes (<5 MB) \u2013 JPEG y PNG<\/li>\n\n\n\n
- Videos (<16 MB) \u2013 MP4 y 3GP<\/li>\n\n\n\n
- Stickers (<100 kB) \u2013 WebP<\/li>\n<\/ul>\n\n
Conclusi\u00f3n<\/h4>\n\n