Tenha preparados estes tr\u00eas itens:<\/p>\n\n
- \n
- Um ID do WhatsApp Business.<\/li>\n\n\n\n
- Um ID de n\u00famero de telefone ou um ID de telefone de teste.<\/li>\n\n\n\n
- Seu token de usu\u00e1rio do sistema com as permiss\u00f5es necess\u00e1rias abaixo:<\/li>\n<\/ul>\n\n
(whatsapp_business_management, whatsapp_business_messaging e business_management).<\/p>\n\n
Se a expectativa para ver o app final for muito grande, confira o c\u00f3digo do projeto final<\/a>.<\/p>\n\n
Como criar um app b\u00e1sico<\/h4>\n\n
Para esta demonstra\u00e7\u00e3o, voc\u00ea usar\u00e1 este servidor Node.js e Express.js de esqueleto b\u00e1sico junto com as depend\u00eancias necess\u00e1rias e as fun\u00e7\u00f5es de esqueleto j\u00e1 criadas.<\/p>\n\n
O tutorial tamb\u00e9m tem um pacote de solicita\u00e7\u00e3o<\/u><\/a> para realizar solicita\u00e7\u00f5es HTTP conforme seu app se comunica com uma API. H\u00e1 duas vari\u00e1veis no arquivo .env do app:<\/p>\n\n
META_AUTH_TOKEN e MESSAGING_PRODUCT.<\/p>\n\n
![\"M\u00eddia](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/image1.png\")
<\/figure>\n\nAp\u00f3s a configura\u00e7\u00e3o do servidor, voc\u00ea poder\u00e1 ir diretamente para a cria\u00e7\u00e3o da API.<\/p>\n\n
Carregar uma imagem para uma mensagem de m\u00eddia<\/h4>\n\n
Antes de poder enviar mensagens baseadas em m\u00eddia usando o WhatsApp, voc\u00ea precisa carregar m\u00eddias para o WhatsApp acessar posteriormente. Os arquivos de m\u00eddia carregados no WhatsApp permanecem por 30 dias, a menos que sejam exclu\u00eddos.<\/p>\n\n
Voc\u00ea precisa criar uma nova rota POST dentro do arquivo routes\/media.js que voc\u00ea pode usar para gerenciar sua m\u00eddia. Conforme a documenta\u00e7\u00e3o<\/u><\/a>, voc\u00ea precisa passar quatro itens:<\/p>\n\n
- \n
- ID do n\u00famero de telefone, que voc\u00ea passa como par\u00e2metro.<\/li>\n\n\n\n
- O arquivo que voc\u00ea deseja carregar, que voc\u00ea passa como dados de formul\u00e1rio.<\/li>\n\n\n\n
- Tipo de arquivo de carregamento, que voc\u00ea gera usando a fun\u00e7\u00e3o auxiliar.<\/li>\n\n\n\n
- Produto de mensagens, que voc\u00ea recebe do arquivo .env.<\/li>\n<\/ul>\n\n
No entanto, quando voc\u00ea cria uma chamada \u00e0 API, s\u00f3 precisa de um arquivo e um ID de n\u00famero de telefone. Os campos restantes voc\u00ea gera usando as fun\u00e7\u00f5es auxiliares.<\/p>\n\n
Voc\u00ea usa o pacote npm formidable<\/u><\/a> para processar os dados de formul\u00e1rio. A API do WhatsApp Business tem algumas limita\u00e7\u00f5es de tipos e tamanhos espec\u00edficos, que voc\u00ea pode consultar na se\u00e7\u00e3o Tipos de m\u00eddia aceitos na parte inferior da Documenta\u00e7\u00e3o de m\u00eddia<\/u><\/a>. H\u00e1 duas fun\u00e7\u00f5es auxiliares no arquivo helper\/validations.js do projeto de esqueleto para lidar com essas limita\u00e7\u00f5es.<\/p>\n\n
Para carregar uma imagem, voc\u00ea precisa inicializar um novo formul\u00e1rio formidable. Usando o objeto de formul\u00e1rio, analise o arquivo e execute algumas valida\u00e7\u00f5es usando as fun\u00e7\u00f5es auxiliares. Em seguida, execute uma solicita\u00e7\u00e3o POST com os dados do formul\u00e1rio e um token de autentica\u00e7\u00e3o v\u00e1lido usando a solicita\u00e7\u00e3o.<\/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: \"Media could not be uploaded\", }); } if (!files.file) { return res.status(400).json({ error: \"Media File is required\", }); } let isFileValidSize = validateMediaSize(files.file.size, files.file.type); if (!isFileValidSize) { return res.status(400).json({ error: `Media File size should be less than ${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\nAp\u00f3s adicionar essa fun\u00e7\u00e3o, voc\u00ea poder\u00e1 testar essa rota usando o Postman. \u00c9 assim que deve ficar o objeto final na interface do Postman:<\/p>\n\n
![\"Imagem](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/image3.png\")
<\/figure>\n\nDepois de clicar em Enviar<\/b>, voc\u00ea receber\u00e1 o ID da m\u00eddia carregada como resposta da API.<\/p>\n\n
![\"Imagem](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/image5.png\")
<\/figure>\n\nAnote o ID da m\u00eddia carregada, pois vamos us\u00e1-lo mais adiante neste tutorial. Se voc\u00ea estiver criando um app com uma camada de dados, poder\u00e1 armazenar esse ID no seu banco de dados para uso posterior. Outra op\u00e7\u00e3o \u00e9 seu app de front-end armazenar o ID temporariamente nas vari\u00e1veis ou no estado.<\/p>\n\n
Como enviar uma mensagem de m\u00eddia<\/h4>\n\n
Agora, use o ID de m\u00eddia que voc\u00ea recuperou na etapa anterior para enviar uma mensagem de m\u00eddia ao cliente. Conforme a Refer\u00eancia de API<\/u><\/a>, voc\u00ea deve enviar cinco itens \u00e0 API para conseguir enviar a mensagem de m\u00eddia ao cliente:<\/p>\n\n
- \n
- ID do n\u00famero de telefone passado como par\u00e2metros<\/li>\n\n\n\n
- N\u00famero de telefone do cliente enviado no corpo da solicita\u00e7\u00e3o<\/li>\n\n\n\n
- Tipo de m\u00eddia enviado no corpo da solicita\u00e7\u00e3o<\/li>\n\n\n\n
- ID de m\u00eddia enviado no corpo da solicita\u00e7\u00e3o<\/li>\n\n\n\n
- Tipo de destinat\u00e1rio, uma pessoa nesse caso<\/li>\n<\/ul>\n\n
A fun\u00e7\u00e3o fica assim:<\/p>\n\n
exports.sendMediaMessage = async (req, res) => { const { id, to, type } = req.body; if (!id || !to || !type) { return res.status(400).json({ error: \"Required Fields: 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\nSe voc\u00ea executar esse ponto de extremidade no Postman, com os detalhes e argumentos necess\u00e1rios, o resultado ficar\u00e1 assim.<\/p>\n\n
![\"Imagem](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/image6.png\")
<\/figure>\n\nDepois de enviar, voc\u00ea ver\u00e1 a seguinte sa\u00edda no Postman, que tamb\u00e9m inclui o ID da mensagem.<\/p>\n\n
![\"Imagem](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/image7.png\")
<\/figure>\n\nVisualiza\u00e7\u00e3o de itens de m\u00eddia<\/h4>\n\n
\u00c9 poss\u00edvel recuperar a URL de m\u00eddia facilmente com a opera\u00e7\u00e3o GET e o ID de m\u00eddia obtido ou armazenado.<\/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\n\u00c9 assim que a solicita\u00e7\u00e3o e a resposta do Postman ficam depois de se obter o item de m\u00eddia com sucesso.<\/p>\n\n
![\"Imagem](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/image4.png\")
<\/figure>\n\nComo excluir m\u00eddias<\/h4>\n\n
Para excluir uma m\u00eddia, voc\u00ea usar\u00e1 o mesmo ponto de extremidade da API do WhatsApp para solicita\u00e7\u00f5es de m\u00eddia com a opera\u00e7\u00e3o 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\nAp\u00f3s a exclus\u00e3o bem-sucedida da m\u00eddia, a API enviar\u00e1 a seguinte resposta:<\/p>\n\n
![\"Imagem](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/image2.png\")
<\/figure>\n\nSaiba mais sobre a Plataforma do WhatsApp Business<\/h4>\n\n
Este tutorial \u00e9 s\u00f3 um exemplo do que voc\u00ea pode fazer com a Plataforma do WhatsApp Business. Enquanto planeja o pr\u00f3ximo projeto, confira a Documenta\u00e7\u00e3o da Plataforma do WhatsApp Business<\/u><\/a> para ter um entendimento completo das funcionalidades e limita\u00e7\u00f5es de m\u00eddia.<\/p>\n\n
Tenha em mente o seguinte:<\/p>\n\n
- \n
- A m\u00eddia carregada dura apenas trinta dias<\/li>\n\n\n\n
- As URLs de download geradas duram apenas cinco minutos<\/li>\n\n\n\n
- Sempre salve o ID da m\u00eddia quando carregar um arquivo<\/li>\n<\/ul>\n\n
Eis uma lista dos tipos de m\u00eddia aceitos. Consulte mais informa\u00e7\u00f5es em Tipos de m\u00eddia aceitos<\/u><\/a>.<\/p>\n\n
- \n
- \u00c1udio (<16 MB) \u2013 Formatos ACC, MP4, MPEG, AMR e OGG<\/li>\n\n\n\n
- Documentos (<100 MB) \u2013 Formatos de texto, PDF, Office e Open Office<\/li>\n\n\n\n
- Imagens (<5 MB) \u2013 Formatos JPEG e PNG<\/li>\n\n\n\n
- V\u00eddeo (<16 MB) \u2013 Formatos MP4 e 3GP<\/li>\n\n\n\n
- Figurinhas (<100 KB) \u2013 Formato WebP<\/li>\n<\/ul>\n\n
Conclus\u00e3o<\/h4>\n\n
Ao usar as mensagens de m\u00eddia avan\u00e7ada da <\/u>Plataforma do WhatsApp Business<\/u><\/a>, voc\u00ea cria oportunidades para engajar seus clientes. Criar um app baseado em API permite coletar e formar uma biblioteca de m\u00eddia que os usu\u00e1rios podem usar para enviar mensagens de forma consistente e eficiente, reduzindo trabalhos repetitivos.<\/p>\n\n