API WhatsAPP Business
Enviar / Receber mensagens, imagens, áudios e vídeos através do WhatsAPP de forma automatizada por API
- API HTTP, envie voz de qualquer linguagem de programação.
- API oficial, trabalhamos com a API oficial do Facebook
- 99,9% SLA, Otimizamos o desempenho de todos os servidores.
- Conectividade máxima, compatível com qualquer celular com WhatsAPP
Funcionalidades da API do WhatsAPP Business
Envie uma mensagem pelo WhatsAPP
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=whatsapp | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=sendmessage | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
user | Utilizador e email da sua conta Afilnet | Mandatório |
password | Password da sua conta Afilnet | Mandatório |
platformid | Identificador de plataforma | Mandatório |
destination | whatsapp.sendmessage_destination | Mandatório |
message | whatsapp.sendmessage_message | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
Código | Descrição |
---|---|
MISSING_USER | Utilizador ou email não incluído |
MISSING_PASSWORD | Password não incluída |
MISSING_CLASS | Classe não incluída |
MISSING_METHOD | Método não incluído |
MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
INCORRECT_CLASS | Classe incorreta |
INCORRECT_METHOD | Método incorreto |
CHANNEL_NOT_FOUND | O canal indicado não existe |
Parâmetros:
- class : whatsapp
- method : sendmessage
- user : user
- password : password
- platformid : 100
- destination : 3460000000
- message : test+message
Pedido:
Envie um arquivo pelo WhatsAPP
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=whatsapp | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=sendfile | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
user | Utilizador e email da sua conta Afilnet | Mandatório |
password | Password da sua conta Afilnet | Mandatório |
platformid | Identificador de plataforma | Mandatório |
destination | whatsapp.sendfile_destination | Mandatório |
type | whatsapp.sendfile_type | Mandatório |
fileurl | whatsapp.sendfile_fileurl | Mandatório |
thumburl | whatsapp.sendfile_thumburl | Opcional |
message | whatsapp.sendfile_message | Opcional |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
Código | Descrição |
---|---|
MISSING_USER | Utilizador ou email não incluído |
MISSING_PASSWORD | Password não incluída |
MISSING_CLASS | Classe não incluída |
MISSING_METHOD | Método não incluído |
MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
INCORRECT_CLASS | Classe incorreta |
INCORRECT_METHOD | Método incorreto |
CHANNEL_NOT_FOUND | O canal indicado não existe |
CHAT_NOT_FOUND | O chat indicado não existe |
INCORRECT_FILETYPE | O tipo de arquivo está errado, verifique os valores possíveis |
INCORRECT_FILEURL | O url do arquivo não é válido |
INCORRECT_THUMBURL | O url da miniatura é inválido |
Parâmetros:
- class : whatsapp
- method : sendfile
- user : user
- password : password
- platformid : 100
- destination : 3460000000
- type : image
- fileurl : https://www.example.com/image.jpg
- thumburl : https://www.example.com/thumb.jpg
- message : test+message
Pedido:
Envie um modelo de mensagem via WhatsApp
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=whatsapp | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=sendmessagefromtemplate | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
user | Utilizador e email da sua conta Afilnet | Mandatório |
password | Password da sua conta Afilnet | Mandatório |
idtemplate | Identificador do modelo | Mandatório |
platformid | Identificador de plataforma | Mandatório |
destination | Destinatário da mensagem (Número em formato internacional) | Mandatório |
options | As opções permitem parametrizar e configurar a mensagem a enviar (Ver Anexo). | Opcional |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
Código | Descrição |
---|---|
MISSING_USER | Utilizador ou email não incluído |
MISSING_PASSWORD | Password não incluída |
MISSING_CLASS | Classe não incluída |
MISSING_METHOD | Método não incluído |
MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
INCORRECT_CLASS | Classe incorreta |
INCORRECT_METHOD | Método incorreto |
CHANNEL_NOT_FOUND | O canal indicado não existe |
Parâmetros:
- class : whatsapp
- method : sendmessagefromtemplate
- user : user
- password : password
- idtemplate : 100
- platformid : 100
- destination : 3460000000
- options : {"header":{"file":"url"}}
Pedido:
Obtenha uma lista de conversas WhatsAPP
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=whatsapp | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=getchats | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
user | Utilizador e email da sua conta Afilnet | Mandatório |
password | Password da sua conta Afilnet | Mandatório |
platformid | Identificador de plataforma | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
-
list
- platformid
- message
- destination
- messageid
- sent
- status
- datetime
-
list
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
Código | Descrição |
---|---|
MISSING_USER | Utilizador ou email não incluído |
MISSING_PASSWORD | Password não incluída |
MISSING_CLASS | Classe não incluída |
MISSING_METHOD | Método não incluído |
MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
INCORRECT_CLASS | Classe incorreta |
INCORRECT_METHOD | Método incorreto |
CHANNEL_NOT_FOUND | O canal indicado não existe |
CHAT_NOT_FOUND | O chat indicado não existe |
Parâmetros:
- class : whatsapp
- method : getchats
- user : user
- password : password
- platformid : 100
Pedido:
Obtenha uma lista de mensagens WhatsAPP
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=whatsapp | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=getmessages | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
user | Utilizador e email da sua conta Afilnet | Mandatório |
password | Password da sua conta Afilnet | Mandatório |
platformid | Identificador de plataforma | Mandatório |
destination | Destinatário do qual você deseja obter as mensagens | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
-
list
- platformid
- message
- destination
- messageid
- sent
- status
- datetime
-
list
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
Código | Descrição |
---|---|
MISSING_USER | Utilizador ou email não incluído |
MISSING_PASSWORD | Password não incluída |
MISSING_CLASS | Classe não incluída |
MISSING_METHOD | Método não incluído |
MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
INCORRECT_CLASS | Classe incorreta |
INCORRECT_METHOD | Método incorreto |
CHANNEL_NOT_FOUND | O canal indicado não existe |
CHAT_NOT_FOUND | O chat indicado não existe |
Parâmetros:
- class : whatsapp
- method : getmessages
- user : user
- password : password
- platformid : 100
- destination : 34600000000
Pedido:
Obtenha uma lista de mensagens não lidas de um bate-papo WhatsAPP
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=whatsapp | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=getunreadmessages | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
user | Utilizador e email da sua conta Afilnet | Mandatório |
password | Password da sua conta Afilnet | Mandatório |
platformid | Identificador de plataforma | Mandatório |
destination | Destinatário do qual você deseja obter as mensagens | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
-
list
- platformid
- message
- destination
- messageid
- issent
- status
- datetime
-
list
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
Código | Descrição |
---|---|
MISSING_USER | Utilizador ou email não incluído |
MISSING_PASSWORD | Password não incluída |
MISSING_CLASS | Classe não incluída |
MISSING_METHOD | Método não incluído |
MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
INCORRECT_CLASS | Classe incorreta |
INCORRECT_METHOD | Método incorreto |
CHANNEL_NOT_FOUND | O canal indicado não existe |
CHAT_NOT_FOUND | O chat indicado não existe |
Parâmetros:
- class : whatsapp
- method : getunreadmessages
- user : user
- password : password
- platformid : 100
- destination : 34600000000
Pedido:
ANEXO: Opções adicionais em Mensagens
Neste anexo você aprenderá como enviar mensagens a partir de seus modelos. Os templates do WhatsAPP permitem enviar mensagens mais elaboradas do que mensagens de texto, permitindo anexar arquivos, além de incluir botões em suas mensagens.
Opções
As opções permitem enviar mensagens interativas, anexar imagens, vídeos, documentos e compartilhar localizações via WhatsApp. Para fazer isso, aqui você aprenderá como personalizar o parâmetro "opções". O parâmetro “options” deve ser uma string no formato JSON seguindo as seguintes especificações:
Parâmetros principais
header | Detalhes sobre o cabeçalho da mensagem (opcional) |
---|---|
params | Valores para os diferentes valores do modelo (opcional) |
Exemplo
{"header":"", "params": ""} |
Defina o cabeçalho
Definir um cabeçalho permitirá anexar diferentes arquivos e serviços às suas mensagens do WhatsApp
Envie uma imagem
file | URL da imagem (formatos permitidos: JPG, PNG, WEBP) O arquivo deve ser carregado na internet e acessível através de uma URL
|
---|
Envie um vídeo
file | URL do vídeo (formatos permitidos: MP4, MPEG, 3GP) O arquivo deve ser carregado na internet e acessível através de uma URL
|
---|
Envie um documento
file | URL do documento (formatos permitidos: TXT, PDF, PPT, DOC, DOCX, XLS, PPTX, XLSX) O arquivo deve ser carregado na internet e acessível através de uma URL
|
---|
Envie um local
file | Latitude e longitude com o formato: (0,0000, 0,0000) | ||||
---|---|---|---|---|---|
location |
|
Defina os parâmetros
O uso de parâmetros permitirá que você personalize seus modelos para cada destinatário, permitindo que informações relacionadas ao destinatário sejam incluídas na mensagem. Alguns exemplos dessas informações seriam: Dados pessoais, Dados relacionados à sua conta, Informações de rastreamento, etc.
Exemplo JSON: | {"params":{"name":"John", "orderid": "10"}} |
---|
Exemplos JSON válidos
Envie uma mensagem com parâmetros personalizados
Neste exemplo vamos enviar uma mensagem parametrizada.
Mensagem modelo com parâmetros: | Prezado {{name}}, seu pedido com ID: {{orderid}} saiu de nossos armazéns |
---|---|
Exemplo JSON: | {"params":{"name":"John", "orderid": "10"}} |
Envie uma imagem
Neste exemplo vamos usar um template que tem uma imagem como cabeçalho.
Exemplo JSON: | {"header":{"file":"https:\/\/test.com\/test.jpg"}} |
---|
Envie uma imagem e mensagem com parâmetros personalizados
Neste exemplo vamos usar um template que tem uma imagem como cabeçalho. Anexamos uma imagem com o número de rastreamento.
Mensagem modelo com parâmetros: | Prezado {{name}}, seu pedido com ID: {{orderid}} saiu de nossos armazéns |
---|---|
Exemplo JSON: | {"header":{"file":"https:\/\/test.com\/test.jpg"}, "params":{"name":"John", "orderid": "10"}} |
Envie um vídeo
Neste exemplo vamos usar um template que tem um vídeo como cabeçalho.
Exemplo JSON: | {"header":{"file":"https:\/\/test.com\/test.mp4"}} |
---|
Envie um documento
Neste exemplo vamos usar um template que tem um documento como cabeçalho.
Exemplo JSON: | {"header":{"file":"https:\/\/test.com\/test.mp4"}} |
---|
Envie um local
Neste exemplo, usaremos um modelo que possui um local como cabeçalho.
Exemplo JSON: | {"header":{"file":"(LATITUDE, LONGITUDE)","location":{"name":"NAME","address":"ADDRESS"}}} |
---|
Ferramentas que melhoram nossa API de negócios do WhatsApp
CONEXÃO DE API SEGURA
Segurança à medida do seu negócio
Configure suas conexões API, crie novos acessos e gerencie os existentes.
Filtre todos os acessos API por IP, adicione ou remova IPs habilitados para garantir a segurança de seus acessos.
Acompanhe todas as conexões feitas, API usada e datas / horas de conexão
VÁRIAS APIs
Conectividade sob medida para o seu negócio
Oferecemos várias APIs para se conectar conosco, temos uma API HTTP, BASIC AUTH, SOAP e Autenticação JWT para que você possa se conectar conosco da maneira que desejar.
Conecte-se com qualquer uma das APIs de forma segura, simples e centralizada . A API Afilnet é perfeita para o seu software.
Registros de API
Conheça cada solicitação em detalhes
Graças aos nossos logs poderá rever todas as solicitações feitas e a resposta correspondente da nossa API, que lhe permitirá consultar detalhes quando precisar deles.
A informação que pode consultar é a seguinte:
- IP de origem da solicitação
- Data e hora do pedido
- API e método sendo chamados
- Parâmetros enviados para a API
- Resposta da API
- metadados
Etapas para usar a API do WhatsApp Business
Siga as etapas para acessar a API do WhatsApp Business
Registre-se como um cliente
Você precisa estar registrado como cliente para obter credenciais para usar a API WhatsAPP Business . Depois de se registrar, você pode fazer as solicitações necessárias à nossa API.
Verifique sua empresa no Facebook
Para poder usar a API do WhatsAPP Business, é essencial ter um perfil de negócios verificado no Facebook. Você pode encontrar mais informações no Facebook Business
Adquira WhatsAPP Business
Entre em contato para que possamos lhe fornecer um número virtual do WhatsAPP Business, consulte as tarifas de serviço em nossa página de tarifas.
Integre o WhatsAPP Business
Use os métodos de API que oferecemos e se integrem aos serviços do WhatsAPP Business Afilnet
Recursos do serviço API do WhatsAPP Business
Automatizar WhatsAPP
Automatizar notificações por WhatsAPP por meio de APIÁudio, imagens, vídeos e documentos
Receba e / ou envie os arquivos necessários por meio da API WhatsAPP Business.Gestão de contatos e conversas
Gerencie seus contatos e conversas no WhatsAPP com nossa API.Envie serviços em nuvem por WhatsAPP
Envie arquivos para a nuvem através do WhatsAPP, anexe pesquisas, contratos e muito mais.Segurança da lista branca
Ativar listas brancas e permitir conexões apenas dos IPs incluídos.Múltiplos acessos por conta
Você pode criar quantos usuários desejar para se conectar à API com a mesma conta.Subcontas
Crie subcontas para outras empresas ou departamentos com sua própria conexão e saldo da API.API grátis
Você pode fazer uso da API sem limitações e gratuitamente, você só paga pelo uso dos serviços.FAQ da API do WhatsAPP Business
Aqui você encontrará as perguntas mais comuns que recebemos sobre o serviço API WhatsAPP Business.
Através do WhatsAPP Business API você poderá receber todas as mensagens WhatsAPP enviadas para sua conta, respondê-las e iniciar conversas com mensagens baseadas em modelos pré-autorizados pelo WhatsAPP.
Você só pode enviar WhatsAPP para usuários que previamente permitiram ser contatados por este canal e apenas usando mensagens baseadas em modelos previamente autorizados.
Você pode ter quantos Chats ativos pelo WhatsAPP forem necessários, desde que atenda aos requisitos estabelecidos pelo WhatsAPP.
No serviço WhatsAPP Business API você paga pelos canais ativos do WhatsAPP, você só paga uma mensalidade por número WhatsAPP Business ativo e o preço por conversa (chats ilimitados com um destinatário por 24 horas), você pode consultar mais informações em nosso taxas de página.