Este tutorial ensinará como enviar mensagens para grupos do WhatsApp usando a API.
Comunicação eficiente é crucial para coordenar um projeto, construir uma comunidade ou gerenciar suporte ao cliente. Wassenger simplifica isso permitindo que você gerencie e interaja com grupos do WhatsApp de forma simples. Com a API e as ferramentas de automação do Wassenger, compartilhar mensagens, vídeos, imagens, documentos e notas de voz fica fácil.
Aqui está um guia de como enviar mensagens para grupos do WhatsApp usando Node.js.
🤩 🤖 Wassenger é uma plataforma completa de comunicação e solução de API para WhatsApp. Explore mais de 100+ casos de uso da API e automatize qualquer coisa no WhatsApp fazendo o cadastro para um teste gratuito e comece em minutos!
Se você precisa enviar mensagens a partir do código, pode usar qualquer linguagem de programação para realizar requisições HTTPS à API. Abaixo está o testador de API ao vivo com exemplos de código prontos para uso em várias linguagens de programação.
Requisitos
- Possuir um número de WhatsApp já vinculado à plataforma e online.
- ID do grupo do WhatsApp (WID) que você pode encontrar de duas maneiras:
Como obter o ID do grupo do WhatsApp
Você pode obter o ID do grupo do WhatsApp usando um destes métodos:
- Web: vá para configurações do número > Grupos > Copie o WID do grupo.
- API: consulte os grupos disponíveis no seu número usando este endpoint.
Endpoint da API
Usaremos o seguinte endpoint da API para enviar mensagens a um grupo:
🖥️ Procurando um exemplo de código? Vá para o testador de API ao vivo e obtenha exemplos prontos para uso em mais de 15 linguagens de programação, incluindo Python, JavaScript, PHP, C#, Java, Ruby, Go, Powershell, cURL e mais.
Enviar mensagens automatizadas com Node (fetch)
- Configuração: As variáveis
url,apiKey,phoneemessagesão definidas para facilitar a modificação. - Payload: O payload é criado como um objeto JavaScript e então convertido para string com
JSON.stringify. - Opções: As opções para a requisição
fetchincluem method, headers e body. - Chamada Fetch: A chamada
fetché feita com a URL e as opções. A resposta é verificada quanto ao sucesso, e a resposta em JSON é registrada no console. - Tratamento de Erros: Os erros são capturados e registrados no console.
// Examples requires you to have installed node-fetch Node.js package.
// Install it by running: npm install --save node-fetch or yarn add node-fetch
const fetch = require('node-fetch');
const url = 'https://api.wassenger.com/v1/messages';
const options = {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Token: 'API_TOKEN_GOES_HERE'
},
body: '{"group":"12036302981363@g.us", "message":"Sample group message"}'
};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}
🤩 🤖 Wassenger é uma solução completa de API para WhatsApp. Cadastre-se para um teste gratuito de 7 dias e comece em minutos!
Enviar mensagens automatizadas com Node (Axios)
- Configuração: As variáveis
url,apiKey,phoneemessagesão definidas para facilitar a modificação. - Opções: As opções para a requisição
axiosincluem method, url, headers e data (o payload). - Requisição Axios: O método
axios.requesté chamado com as opções. A resposta é registrada no console em caso de sucesso. - Tratamento de Erros: Os erros são capturados e registrados no console, com diferenciação entre erros de resposta, erros de requisição e erros de configuração.
const axios = require('axios').default;
const options = {
method: 'POST',
url: 'https://api.wassenger.com/v1/messages',
headers: {
'Content-Type': 'application/json',
Token: 'API_TOKEN_GOES_HERE'
},
data: { group: '12036302981363@g.us', message: 'Sample group message' }
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
Enviar mensagens automatizadas com Node (Unirest)
- Configuração: As variáveis
url,apiKey,phoneemessagesão definidas para facilitar a modificação. - Headers: Headers para
Content-TypeeTokensão adicionados à requisição. - Payload: O corpo da requisição é definido como um objeto JSON com o número de telefone e a mensagem.
- Callback de Fim: O método
endé usado para enviar a requisição, e uma função callback trata a resposta. Erros são registrados se ocorrerem, e o corpo da resposta é impresso no console em caso de sucesso.
// Examples requires you to have installed unirest Node.js package.
// Install it by running: npm install --save unirest or yarn add unirest
const unirest = require('unirest');
const req = unirest('POST', 'https://api.wassenger.com/v1/messages');
req.headers({
'Content-Type': 'application/json',
Token: 'API_TOKEN_GOES_HERE'
});
req.type('json');
req.send({
group: '12036302981363@g.us',
message: 'Sample group message'
});
req.end(function (res) {
if (res.error) throw new Error(res.error);
console.log(res.body);
});
🤩 🤖 Wassenger é uma solução completa de API para WhatsApp. Cadastre-se para um teste gratuito de 7 dias e comece em minutos!
Mais exemplos para mensagens em grupo com Node (fetch)
Para (axios e unirest) visite nosso API Live Tester
Enviar imagens para um chat de grupo com Node (fetch)
// Examples requires you to have installed node-fetch Node.js package.
// Install it by running: npm install --save node-fetch or yarn add node-fetch
const fetch = require('node-fetch');
const url = 'https://api.wassenger.com/v1/messages';
const options = {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Token: 'API_TOKEN_GOES_HERE'
},
body: JSON.stringify({
group: '12036302981363@g.us',
message: 'This is a caption for an image message',
media: {
url: 'https://picsum.photos/seed/picsum/600/400'
}
})
};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}
Enviar áudio para um chat de grupo com Node (fetch)
// Examples requires you to have installed node-fetch Node.js package.
// Install it by running: npm install --save node-fetch or yarn add node-fetch
const fetch = require('node-fetch');
const url = 'https://api.wassenger.com/v1/messages';
const options = {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Token: 'API_TOKEN_GOES_HERE'
},
body: JSON.stringify({
group: '12036302981363@g.us',
media: {
url: 'https://download.samplelib.com/mp3/sample-9s.mp3',
format: 'ptt'
}
})
};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}
Enviar vídeo para um chat de grupo com Node (fetch)
// Examples requires you to have installed node-fetch Node.js package.
// Install it by running: npm install --save node-fetch or yarn add node-fetch
const fetch = require('node-fetch');
const url = 'https://api.wassenger.com/v1/messages';
const options = {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Token: 'API_TOKEN_GOES_HERE'
},
body: JSON.stringify({
group: '12036302981363@g.us',
message: 'This is a caption for a video message',
media: {
url: 'https://download.samplelib.com/mp4/sample-5s.mp4'
}
})
};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}
Enviar documentos para um chat de grupo com Node (fetch)
// Examples requires you to have installed node-fetch Node.js package.
// Install it by running: npm install --save node-fetch or yarn add node-fetch
const fetch = require('node-fetch');
const url = 'https://api.wassenger.com/v1/messages';
const options = {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Token: 'API_TOKEN_GOES_HERE'
},
body: JSON.stringify({
group: '12036302981363@g.us',
media: {
url: 'https://www.africau.edu/images/default/sample.pdf'
}
})
};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}
Teste da API ao vivo
Você pode testar a API ao vivo e experimentá-la diretamente do seu navegador.
Quando terminar os testes, obtenha o exemplo de código gerado automaticamente na sua linguagem de programação preferida e você estará pronto para começar.
Experimente nosso testador de API ao vivo agora
Perguntas frequentes
Como enviar mensagens para vários números de telefone
Você só precisa enviar múltiplas requisições à API, uma por número de telefone alvo.
Por exemplo, se você quiser enviar uma mensagem para 10 números de telefone, deve enviar 10 requisições HTTPS independentes para a API.
Não existe opção para enviar múltiplas mensagens em uma única requisição à API.
Como validar se um número de telefone pode receber mensagens do WhatsApp
Você pode validar se um determinado número de telefone está vinculado a uma conta do WhatsApp e pode receber mensagens.
A API oferece um endpoint que pode validar se um determinado número de telefone existe no WhatsApp ou não.
O único requisito é ter pelo menos um número de WhatsApp conectado à plataforma na sua conta atual.
Para mais detalhes, por favor consulte a documentação do endpoint da API aqui.
Antes de verificar se um número de telefone existe no WhatsApp, você também pode validar e normalizar o formato de uma lista de números de telefone usando o endpoint validador de números. Este endpoint apenas valida o formato correto E164, mas não verifica se o número de telefone efetivamente existe no WhatsApp.
Nota: O número de validações de verificação no WhatsApp é limitado por mês com base no seu plano de assinatura. Por favor, consulte a tabela de preços para mais detalhes sobre os limites.
Procurando mais respostas? Consulte as FAQs estendidas.
Recursos úteis adicionais
Documentação da API
Para mais detalhes sobre o endpoint da API, por favor consulte a documentação onde você encontrará todos os detalhes sobre os parâmetros aceitos na requisição, possíveis respostas de sucesso ou erro e exemplos de código prontos para uso em múltiplas linguagens de programação:
https://app.wassenger.com/docs/#tag/Messages/operation/createMessage
