Enviar imagens e outras mídias via WhatsApp usando o Node.js

Tempo de leitura: 2 minutos

April 16, 2019

Escrito por

Twilion

Enviar imagens e outras mídias via WhatsApp usando o Node.js

Com a API da Twilio para WhatsApp, você pode não apenas enviar mensagens de texto para números WhatsApp, mas também enviar e receber mensagens de mídia. Esse recurso permite que você envie imagens (JPG, JPEG, PNG), arquivos de áudio e até mesmo PDFs de até 5 MB. Vamos ver como podemos fazer isso usando o Node.js.

Se preferir assistir a um tutorial em vídeo, confira este vídeo em nosso canal do YouTube:

Pré-requisitos

Antes de começarmos, será necessário:

Ter uma conta Twilio (cadastre-se gratuitamente)
Instalar o Node.js e um gerenciador de pacotes como o npm
Instalar o WhatsApp Sandbox Channel (saiba como ativar o Sandbox do WhatsApp)
Definir o Account SID (SID da conta) e o Auth Token (token de autenticação) como variáveis de ambiente

Se você quiser tentar isso, configure um novo projeto executando:

mkdir whatsapp-media-messages
cd whatsapp-media-messages
npm init -y

Envie sua primeira mensagem de mídia

Instale a biblioteca auxiliar twilio executando:

npm install twilio

Crie um novo arquivo chamado index.js e insira o seguinte código nele:

const twilio = require('twilio');
const client = twilio(
 process.env.TWILIO_ACCOUNT_SID,
 process.env.TWILIO_AUTH_TOKEN
);

client.messages
 .create({
   from: 'whatsapp:+WHATSAPP_SANDBOX_NUMBER',
   to: 'whatsapp:+YOUR_NUMBER',
   body: 'Ahoy from Twilio',
   mediaUrl: 'https://bit.ly/whatsapp-image-example',
 })
 .then(message => {
   console.log(message.sid);
 })
 .catch(err => {
   console.error(err);
 });

Isso inicializará um Twilio Client usando a biblioteca auxiliar twilio e, em seguida, criará uma nova mensagem para o seu número de WhatsApp. Altere WHATSAPP_SANDBOX_NUMBER e YOUR_NUMBER para os respectivos números e, se preferir, altere o valor de mediaUrl para um URL de qualquer outra imagem, trecho de código de som ou PDF.

Depois, execute o código:

node index.js

Você receberá uma mensagem com a mídia e o texto que enviou.

Tela do celular com o chat de WhatsApp da sandbox da Twilio com uma mensagem contendo imagem enviada via API.

O que vem a seguir?

Há algumas diferenças entre mensagens de mídia MMS e WhatsApp. As mensagens de mídia só poderão ser enviadas aos usuários do WhatsApp se houver uma session ativa estabelecida. As sessões são criadas quando um usuário responde a uma mensagem de modelo ou inicia a conversa enviando uma mensagem. Uma sessão dura 24 horas desde a última mensagem do usuário. Além disso, as mensagens de mídia do WhatsApp não são compatíveis com alguns tipos de arquivo aceitos pelo MMS. Para obter mais informações sobre o suporte a tipos de arquivo, consulte as Perguntas frequentes.

Para conferir outras possibilidades que a API para WhatsApp da Twilio oferece, confira as seguintes publicações:

Estou ansioso para ver o que você vai criar.

Este artigo foi traduzido do original "Send Images and Other Media via WhatsApp Using Node". Enquanto melhoramos nossos processos de tradução, adoraríamos receber seus comentários em help@twilio.com - contribuições valiosas podem render brindes da Twilio.

Publicações relacionadas

Recursos relacionados

Twilio Docs

De APIs a SDKs e aplicativos de amostra

Documentação de referência de API, SDKs, bibliotecas auxiliares, guias de início rápido e tutoriais para sua linguagem e plataforma.

Centro de Recursos

Os mais recentes e-books, relatórios do setor e webinars

Aprenda com especialistas em engajamento do cliente para melhorar sua própria comunicação.

Ahoy

Centro da comunidade de desenvolvedores da Twilio

Melhores práticas, exemplos de código e inspiração para criar comunicações e experiências de engajamento digital.