Como enviar Mensagens de WhatsApp usando Node.js e a API da Zenvia

SOUTH SYSTEM
4 min readMar 10, 2022

--

Pré-requisito:

● Realizar os passos para configurar a integração com a API do Whatsapp da ZENVIA:
https://www.zenvia.com/blog/developers/mensagens-de-whatsapp/
● Conhecimento básico em Node.js
● Node.js e NPM
● Terminal Bash
● Postman

Whatsapp: passo a passo para envio de mensagem utilizando Node.js

Etapa 1: Inicializando projeto utilizando framework NestJS

Abra um terminal e execute os comandos para realizar a instalação do CLI e iniciar uma estrutura básica do projeto:

Após a instalação será gerado uma estrutura básica do framework:

Estrutura básica do NestJS

Etapa 2: Instalação do SDK e Integração com a Plataforma ZENVIA

Entre na pasta do projeto e realize a instalação do SDK para Node.js e demais dependências, SDK ZENVIA disponível em:

No terminal execute os comandos:

Utilizando seu editor de código de preferência abra a pasta do projeto e vamos codar. Após abrir seu editor na pasta do projeto será possível visualizar a estrutura inicial:

Estrutura Inicial

Agora será necessário realizar as configurações para utilização de variáveis de ambiente no format DotEnv no NestJS, abra o arquivo app.module.ts e realize importação do módulo de configuração:

app.module.ts

Feito a importação do módulo de configuração, crie um arquivo chamado .env na raiz do projeto:

.env

Substitua SEU_TOKEN_ZENVIA_AQUI pelo token da API Zenvia e SEU_NUMERO_AQUI pelo seu número da conta de whatsapp registrado na plataforma Zenvia para realização de disparos de mensagens whatsapp.

Feito isso podemos utilizar o SDK NodeJS da Zenvia para realizar os disparos. Vamos criar um serviço para realizar os envios. Dentro da pasta src crie um arquivo chamado whatsapp.service.ts conforme abaixo:

whatsapp.service.ts

Agora adicione a classe WhatsappService nos providers do app.module.ts:

app.module.ts

O próximo passo é consumir o serviço criado dentro de um controlador que receberá uma requisição e irá realizar o envio da mensagem por meio do WhatsappService. Crie um arquivo chamado whatsapp.request.ts dentro da pasta src:

whatsapp.request.ts

Abra o arquivo app.controller.ts crie um método (sendWhatsappMessage) conforme abaixo e realize o consumo do serviço WhatsappService passando os dados recebidos na requisição:

app.controller.ts

Agora nosso código está pronto para ser executado, no terminal execute o comando abaixo para iniciar nosso projeto:

O projeto foi inicializado e nossa API se encontra na url:

Projeto iniciado

Agora podemos realizar o teste da nossa API utilizando a ferramenta postman, crie uma requisição do tipo POST para http://localhost:3000/whatsapp com o JSON abaixo:

JSON da Requisição

Substitua no JSON o campo to pelo seu número de telefone e clique em enviar:

Resultado do disparo da mensagem

Finalmente você pode conferir no seu whatsapp a nova mensagem:

Mensagem recebida

O código deste tutorial está disponível em:

Referências:

--

--

SOUTH SYSTEM
SOUTH SYSTEM

Written by SOUTH SYSTEM

Impulsionar pessoas para inovar o mundo

No responses yet