Quando voc\u00ea usa a Plataforma do WhatsApp Business para gerar esses modelos, agiliza a comunica\u00e7\u00e3o com os clientes e melhora consideravelmente a experi\u00eancia do usu\u00e1rio.<\/p>\n\n
Veja s\u00f3 este exemplo. Uma ag\u00eancia de viagens hipot\u00e9tica chamada “Viagens Incr\u00edveis Ltda.” oferece servi\u00e7os de reserva de transporte, hospedagem e atividades recreativas. Como o WhatsApp est\u00e1 presente no mundo inteiro, isso o torna uma plataforma ideal para essa empresa se comunicar com os clientes. As confirma\u00e7\u00f5es por e-mail s\u00e3o excelentes para manter informa\u00e7\u00f5es registradas. Contudo, poder interagir com os clientes em conversas bidirecionais \u00e9 de grande valor para quem est\u00e1 viajando, e isso os SMS tradicionais n\u00e3o conseguem oferecer.<\/p>\n\n
Ademais, com os modelos de mensagem do WhatsApp, a Viagens Incr\u00edveis Ltda. consegue se comunicar passando a quantidade ideal de detalhes personalizados. Nesse exemplo, com uma mensagem de boas-vindas personalizada, notifica\u00e7\u00f5es em tempo h\u00e1bil e passagens eletr\u00f4nicas acess\u00edveis instantaneamente, os clientes t\u00eam a certeza de que a viagem deles est\u00e1 sendo gerida, e isso permite que eles relaxem e aproveitem as f\u00e9rias.<\/p>\n\n
Para voc\u00ea ver como \u00e9 f\u00e1cil aproveitar todos os recursos da API do WhatsApp Business e dos modelos de mensagem, o presente tutorial pr\u00e1tico guiar\u00e1 voc\u00ea pelos processos de gerenciamento de modelos, incluindo a cria\u00e7\u00e3o, a exclus\u00e3o e a personaliza\u00e7\u00e3o.<\/p>\n\n
Como gerenciar modelos de mensagem com a Plataforma do WhatsApp Business<\/h4>\n\nPr\u00e9-requisitos<\/b><\/h6>\n\n
Este tutorial parte do princ\u00edpio de que voc\u00ea tem um conhecimento b\u00e1sico dos apps Node.js<\/u><\/a> e Express.js<\/u><\/a>. Antes de continuar, conclua as etapas fornecidas na se\u00e7\u00e3o introdut\u00f3ria<\/u><\/a> da documenta\u00e7\u00e3o da Plataforma do WhatsApp Business. Se voc\u00ea for um provedor de solu\u00e7\u00f5es empresariais<\/u><\/a> (BSP), siga os Primeiros passos para provedores de solu\u00e7\u00f5es empresariais<\/u><\/a> e garanta que seu app da Meta passe no processo de an\u00e1lise.<\/p>\n\n Antes de continuar com o tutorial, confirme que voc\u00ea tem um ID do WhatsApp Business e um ID do n\u00famero de telefone.<\/p>\n\n Os BSPs tamb\u00e9m precisam de um token de usu\u00e1rio do sistema com as permiss\u00f5es necess\u00e1rias (whatsapp_business_management, whatsapp_business_messaging e business_management).<\/p>\n\n Se voc\u00ea n\u00e3o tiver os apps Node.js e Express.js, poder\u00e1 usar este padr\u00e3o de app<\/a> criado especificamente para o tutorial.<\/p>\n\n Al\u00e9m disso, o tutorial usar\u00e1 v\u00e1rios pacotes, incluindo o dotenv, para armazenar o token e as solicita\u00e7\u00f5es para fazer solicita\u00e7\u00f5es HTTP com a API. Tamb\u00e9m usaremos o Postman<\/u><\/a> para testar os pontos de extremidade da API.<\/p>\n\n Para explorar mais, veja aqui<\/a> o c\u00f3digo completo.<\/p>\n\n Quando voc\u00ea configurar o app inicial e adicionar o token com as devidas permiss\u00f5es, j\u00e1 ter\u00e1 tudo pronto para come\u00e7ar.<\/p>\n\n Vamos supor que a Global Voyager queira criar v\u00e1rios modelos de mensagem, um para cada finalidade. Por exemplo, um modelo para enviar uma sauda\u00e7\u00e3o aos clientes e outro para enviar c\u00f3pias em PDF de documentos relevantes.<\/p>\n\n Antes de come\u00e7ar com a codifica\u00e7\u00e3o, tire um tempinho para entender o funcionamento do processo de cria\u00e7\u00e3o de modelos e os tipos de par\u00e2metros aceitos. Observe tamb\u00e9m que a Meta analisa os modelos diariamente e poder\u00e1 rejeit\u00e1-los se n\u00e3o atenderem \u00e0s diretrizes<\/u><\/a> especificadas.<\/p>\n\n A documenta\u00e7\u00e3o<\/u><\/a> informa que voc\u00ea precisa fazer uma solicita\u00e7\u00e3o POST para message_templates usando seu ID do WhatsApp Business.<\/p>\n\n Os par\u00e2metros a seguir s\u00e3o aceitos:<\/p>\n\n O par\u00e2metro de componentes define o corpo do modelo de mensagem. Ele aceita os seguintes subpar\u00e2metros:<\/p>\n\n Agora voc\u00ea tem um modelo de mensagem baseado em texto para saudar os clientes e outro baseado em m\u00eddia para enviar um PDF. Pensando em nosso exemplo, esses modelos seriam perfeitos para enviar passagens ou confirma\u00e7\u00f5es de itiner\u00e1rio.<\/p>\n\n Primeiro, voc\u00ea precisa criar um novo roteador em routes\/messageTemplates.js:<\/p>\n\n Em seguida, use o m\u00e9todo de controlador createMessageTemplate, que faremos em controllers\/messageTemplate.js:<\/p>\n\n Agora que criamos a rota e o m\u00e9todo, \u00e9 hora de testar a API no Postman. Ficar\u00e1 assim:<\/p>\n\n E o retorno, assim:<\/p>\n\n Veja abaixo um exemplo de objeto de solicita\u00e7\u00e3o que voc\u00ea pode passar para criar o modelo de mensagem. {{1}} \u00e9 usado para passar vari\u00e1veis. Vale lembrar que {{X}} \u00e9 usado para definir as vari\u00e1veis do modelo de mensagem, e n\u00e3o as vari\u00e1veis do Postman.<\/p>\n\n A resposta bem-sucedida da API retorna o valor do ID, representando o ID do modelo.<\/p>\n\n Quando concluir o modelo baseado em texto, voc\u00ea poder\u00e1 criar modelos baseados em m\u00eddia com a mesma facilidade. S\u00e3o meios flex\u00edveis e eficientes de enviar documentos que os clientes podem acessar imediatamente.<\/p>\n\n O modelo abaixo ter\u00e1 um HEADER que incluir\u00e1 o documento anexado, um componente BODY e um componente FOOTER:<\/p>\n\n Observa\u00e7\u00e3o<\/b>: antes de voc\u00ea poder usar os modelos de mensagem para se comunicar com os clientes, os modelos precisam ser aprovados e atender \u00e0s Diretrizes para Modelo de Mensagem<\/u><\/a>.<\/p>\n\n Agora que voc\u00ea criou os modelos de mensagem, j\u00e1 pode recuper\u00e1-los. Para isso, fa\u00e7a uma chamada GET para:<\/p>\n\n Observa\u00e7\u00e3o: a vers\u00e3o da API pode mudar. Garanta que sua URL seja atualizada de acordo.<\/p>\n\n Em seguida, crie uma nova rota em routes\/messageTemplates.js:<\/p>\n\n O getMessageTemplates acima \u00e9 um m\u00e9todo de controlador que voc\u00ea pode criar em controllers\/messageTemplate.js. Veja abaixo:<\/p>\n\n Uma resposta bem-sucedida inclui os modelos que voc\u00ea criou e o exemplo de modelo do WhatsApp.<\/p>\n\n De forma parecida com a rota GET, voc\u00ea tamb\u00e9m pode criar uma rota DELETE em routes\/messageTemplates.js:<\/p>\n\n Agora, crie o m\u00e9todo controlador de apoio em controllers\/messageTemplates.js:<\/p>\n\n Para excluir um modelo, voc\u00ea precisa passar o nome do modelo como um corpo JSON.<\/p>\n\n Por exemplo, as capturas de tela abaixo mostram uma solicita\u00e7\u00e3o e uma resposta Postman bem-sucedidas para excluir um modelo denominado demo_template_user:<\/p>\n\n Agora, vamos usar um modelo de mensagem para enviar mensagens.<\/p>\n\n Primeiro, fa\u00e7a um roteador e o respectivo controlador de apoio. Em routes\/messageTemplates.js, adicione:<\/p>\n\n No c\u00f3digo acima, o par\u00e2metro :id \u00e9 usado para passar o ID do n\u00famero de telefone. Veja como o controlador fica em controllers\/messageTemplate.js.<\/p>\n\n Agora voc\u00ea pode criar um objeto de solicita\u00e7\u00e3o no Postman. Lembre-se de que voc\u00ea passar\u00e1 um par\u00e2metro \u2014 {{1}} \u2014 no Header.<\/p>\n\n O corpo de solicita\u00e7\u00e3o Postman demonstra o modelo baseado em texto que criamos.<\/p>\n\n Observe esse trecho de c\u00f3digo na captura de tela acima:<\/p>\n\n Esse trecho \u00e9 usado para passar o valor para o par\u00e2metro {{1}}. Uma resposta bem-sucedida inclui o ID da mensagem, como vemos abaixo.<\/p>\n\n \u00c9 assim que essa mensagem aparece para os clientes no WhatsApp:<\/p>\n\n Em seguida, voc\u00ea usar\u00e1 um objeto de solicita\u00e7\u00e3o JSON para outro modelo no qual precisa passar um documento no HEADER, bem como as vari\u00e1veis {{1}}, {{2}} e {{3}} no BODY.<\/p>\n\n Primeiro, veja a captura de tela abaixo:<\/p>\n\n Note que o trecho abaixo passa os par\u00e2metros para o HEADER:<\/p>\n\n A m\u00eddia anexada pode ser um link ou o ID da m\u00eddia carregada<\/u><\/a>.<\/p>\n\nComo criar um novo modelo de mensagem<\/h4>\n\n
\n
\n
Como criar um modelo de mensagem baseado em texto<\/h4>\n\n
router.post(\"\/messageTemplate\", createMessageTemplate);<\/code><\/pre>\n\nexports.createMessageTemplate = async (req, res) => {exports.createMessageTemplate = async (req, res) => { const { name, language, category, components } = req.body; if (!name || !language || !category || !components) { return res.status(400).json({ error: \"Required Fields: name, language, category, and components\", }); } request.post( { url: `https:\/\/graph.facebook.com\/v13.0\/${process.env.META_BUSINESS_ID}\/message_templates`, headers: { Authorization: `Bearer ${process.env.META_AUTH_TOKEN}`, \"content-type\": \"application\/json\", }, body: JSON.stringify({ name: name, language: language, category: category, components: components, }), }, function (err, resp, body) { if (err) { console.log(\"Error!\"); } else { res.json(JSON.parse(body)); } } ); };<\/code><\/pre>\n\n![\"\"](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/Screen-Shot-2022-05-24-at-10.18.51-AM.png\")
<\/figure>\n\n![\"\"](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/Screen-Shot-2022-05-24-at-10.20.37-AM.png\")
<\/figure>\n\n{ \"name\": \"welcome_greetings\", \"language\": \"en_US\", \"category\": \"ALERT_UPDATE\", \"components\": [ { \"type\": \"HEADER\", \"format\":\"TEXT\", \"text\": \"Oi, {{1}}! Como vai voc\u00ea?\" }, { \"type\": \"BODY\", \"text\": \"Agradecemos por voc\u00ea escolher a Terrific Travel Ltd. como sua concierge de f\u00e9rias! Entre em contato conosco caso tenha d\u00favidas.\" }, { \"type\": \"FOOTER\", \"text\": \"Terrific Travel Ltd.\" } ] }<\/code><\/pre>\n\nComo criar um modelo de mensagem baseado em m\u00eddia<\/h4>\n\n
{ \"name\": \"sample_ticket_confirmation\", \"language\": \"en_US\", \"category\": \"TICKET_UPDATE\", \"components\": [ { \"type\": \"HEADER\", \"format\": \"DOCUMENT\" }, { \"type\": \"BODY\", \"text\": \"This is your flight confirmation for {{1}}-{{2}} on {{3}}.\" }, { \"type\": \"FOOTER\", \"text\": \"This message is from an unverified business.\" } ] }<\/code><\/pre>\n\nComo recuperar uma lista de modelos de mensagem existentes<\/h4>\n\n
https://graph.facebook.com\/v13.0\/whatsapp-business-account-ID\/message_templates.<\/code><\/pre>\n\nrouter.get(\"\/messageTemplates\", getMessageTemplates);<\/code><\/pre>\n\nexports.getMessageTemplates = async (req, res) => { request.get( { url: `https:\/\/graph.facebook.com\/v13.0\/${process.env.META_BUSINESS_ID}\/message_templates`, 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![\"\"](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/Screen-Shot-2022-05-24-at-10.28.09-AM.png\")
<\/figure>\n\n![\"\"](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/Screen-Shot-2022-05-24-at-10.27.18-AM.png\")
<\/figure>\n\nComo excluir um modelo de mensagem<\/h4>\n\n
router.delete(\"\/messageTemplate\", deleteMessageTemplate);<\/code><\/pre>\n\nexports.deleteMessageTemplate = async (req, res) => { request.delete( { url: `https:\/\/graph.facebook.com\/v13.0\/${process.env.META_BUSINESS_ID}\/message_templates`, headers: { Authorization: `Bearer ${process.env.META_AUTH_TOKEN}`, \"content-type\": \"application\/json\", }, body: JSON.stringify({ name: req.body.name, }), }, function (err, resp, body) { if (err) { console.log(\"Error!\"); } else { res.json(JSON.parse(body)); } } ); };<\/code><\/pre>\n\n![\"\"](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/Screen-Shot-2022-05-24-at-10.31.39-AM.png\")
<\/figure>\n\nComo enviar uma mensagem usando o modelo<\/h4>\n\n
router.post(\"\/sendMessage\/:id\", sendMessage);<\/code><\/pre>\n\nexports.sendMessage = async (req, res) => { const { id, to, type,template } = req.body; if (!id || !to || !type || !template) { return res.status(400).json({ error: \"Required Fields: to, type, template 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: JSON.stringify({ messaging_product: process.env.MESSAGING_PRODUCT, to: to, type: type, template: template, }), }, function (err, resp, body) { if (err) { console.log(\"Error!\"); } else { res.json(JSON.parse(body)); } } ); };<\/code><\/pre>\n\n![\"\"](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/Screen-Shot-2022-05-24-at-10.34.38-AM.png\")
<\/figure>\n\n\"components\": [ { \"type\": \"HEADER\", \"parameters\": [ { \"type\": \"text\", \"text\": \"Name\" } ] } ]<\/code><\/pre>\n\n![\"\"](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/Screen-Shot-2022-05-24-at-10.36.58-AM.png\")
<\/figure>\n\n![\"\"](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/Screen-Shot-2022-05-24-at-10.38.31-AM.png\")
<\/figure>\n\n![\"\"](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/Screen-Shot-2022-05-24-at-10.40.25-AM.png\")
<\/figure>\n\n\"parameters\": [ { \"type\": \"DOCUMENT\", \"document\": { \"id\":\"984786545564592\" } } ] }, { Then, the following code does the same for the BODY: \"parameters\": [ { \"type\": \"text\", \"text\": \"Toronto\" }, { \"type\": \"text\", \"text\": \"Dubai\" }, { \"type\": \"text\", \"text\": \"2022-05-03\" } ] } ] } }<\/code><\/pre>\n\n
![\"\"](\"https:\/\/whatsappbusiness.com\/wp-content\/uploads\/2026\/03\/Screen-Shot-2022-05-24-at-10.42.35-AM.png\")
<\/figure>\n\n