Informações úteis para as perguntas mais comuns ao utilizar este serviço.
Last updated
Was this helpful?
Informações úteis para as perguntas mais comuns ao utilizar este serviço.
Last updated
Was this helpful?
Essa API não é afiliada, associada, autorizada, endossada ou de qualquer outra forma conectada oficialmente com o WhatsApp ou qualquer um de seus afiliados ou provedores oficiais. O site oficial do WhatsApp pode ser acessado em e a partir dele ter essas informações. "WhatsApp" assim como nomes relacionados, marcas, emblemas e imagens são marcas registradas de seus respectivos donos.
No momento nós não somos um parceiro global do WhatsApp e por isso, ao utilizar essa API você assume o risco de bloqueio do número no aplicativo, dado que a plataforma não autoriza o uso de bots ou APIs não oficiais e por isso o uso desta não pode ser considerado totalmente seguro de bloqueios.
Ainda assim, a intenção da disponibilização deste serviço é oferecer uma solução alternativa de custo reduzido, menos burocrática e acesso imediato a clientes de pequeno e médio porte que desejam automatizar sua comunicação através do aplicativo, ou até mesmo, em transformar o seu número em uma central de atendimento onde vários agentes podem ter acesso a um único número de forma simultânea.
Apesar de todas as recomendações de boas práticas mencionadas no item a seguir a SMSFire não se responsabiliza por qualquer ônus que o cliente possa sofrer em decorrência do possível bloqueio do número ao aplicativo enquanto utilizar a ferramenta para fins de marketing massivo ou qualquer outro, ora identificado pelo WhatsApp, que venham ferir suas politicas de privacidade e termos de utilização.
Algumas medidas de boas práticas, se adotadas, reduzem o risco de bloqueio e garantem que métodos de API como esta permaneçam ativas por mais tempo. Abaixo listamos algumas medidas que já identificamos que reduzem o risco de bloqueio do número no aplicativo, sendo:
Evite envios em massa para não contatos
Mesmo para contatos, evite envio de mensagens em massa
Tente interagir de modo passivo, ou seja, deixe o contato iniciar a conversa
Utilize o WhatsApp Business com um perfil válido ao invés do WhatsApp convencional
Evite utilizar números recém cadastrados no aplicativo e/ou recém habilitados na operadora
Disponibilize um meio de opt-out para o destinatário solicitar a saída da sua lista de comunicação
Evite envios de links de domínios públicos como bit.ly, goo.gl, entre outros
Evite envios de mensagens a destinatários de países distintos ao do número sincronizado
Evite o envio de imagens ou arquivos sem um texto descritivo (legenda)
Tente personalizar ao máximo o texto para cada destinatário
Não temos informações adicionais e/ou recomendações sobre o volume máximo diário de disparos ou o ideal de espera entre o envio de uma mensagem e outra.
É possível registrar um ou mais endereços de e-mail para receber notificações quando a sua instância ou sincronização sofrer alterações. Para registrar os endereços de e-mail acesse o menu Minha conta → Configurações → Notificações e então ative a opção WhatsApp e siga as orientações em tela.
Durante a utilização da API é necessário manter o dispositivo ativo e com conexão de dados disponível e de boa qualidade. Sem isso, a sincronização poderá ser perdida mesmo nas versões mais recentes de múltiplos dispositivos e suas mensagens e/ou status não serão processados corretamente.
Logo que a instância estiver criada acesse as configurações da mesma para adquirir o TOKEN da instância. Este TOKEN é necessário na utilização dos serviços da API.
Nas configurações da instância, também será possível alterar o seu nome, compartilhar acesso a sub usuários, entre outras opções.
Os sub usuários que receberem permissão para acessar a instância, poderão também realizar a utilização do serviço via API desde que você compartilhe o TOKEN de acesso a eles.
Este processo é importante para que consigamos processar os dados de mensagens enviadas e recebidas além dos dados de webhooks.
Após ter criado a sua instância, mantenha-se no mesmo menu WhatsApp → Instâncias e na linha da instância desejada, clique no botão "Sincronizar WhatsApp", aguarde o carregamento dos dados da instância e então faça o escaneamento do qrcode seguindo as orientações dada em tela.
Após ter criado a sua instância, você acessará o menu WhatsApp → Dashboard. Neste menu, você selecionará a instância que deseja sincronizar e seguir as orientações em tela.
Após a sincronização do Qrcode o seu Dashboard será aberto, e a partir de então, todas as mensagens recebidas (com exceção dos números mencionados em Ignorar Interação nas configurações da instância) serão captadas pelo nosso sistema.
Uma vez sincronizado, mantenha o dispositivo ligado e com conexão a internet ativa. Dessa forma a sincronização permanece ativa e válida para o correto processamento dos dados.
Cada nova interação com um contato, seja ele da sua lista ou não, pode ser considerado como uma sessão que possuí uma duração de 24h corridas a partir da data da última interação.
Quando a sessão é iniciada a tarifa sempre é cobrada do usuário principal, mesmo quando ela tenha sido originada por uma subconta.
A sessão é renovada por mais 24h corridas a partir da última interação de mensagens enviadas ou recebidas, isso se essa situação ocorrer durante uma sessão ativa.
Atualmente a sessão aberta não tem data definida de encerramento, ou seja, após 24h ela não será finalizada. Portanto, verifique com a área comercial em qual fase o serviço encontra-se para ter claro quais são as condições de cobrança do momento.
Todos os dados serão enviados ao seu endpoint encodados em JSON via POST. Cada atualização de status irá gerar uma requisição, ou seja, se você enviar 10 mil mensagens é possível que existam 30 mil requisições a sua URL ao considerar Callbacks, DLRs, MOs e Qrcode.
Você poderá registrar diferentes endpoints para cada tipo de situação como CALLBACK, DLR, MO e QRCODE.
Para registrar seus endpoints acesse o menu Minha conta → Configurações → Webhooks
Devido ao grande volume de requisições que nossa API poderá fazer em seu servidor, recomendamos fortemente a utilização de um software para gerenciamento de filas (RabbitMq ou Kafka por exemplo) para evitar gargalos em seu banco de dados e/ou servidores.
TIMEOUT - 10 segundos Este é o tempo de espera máxima que nossos servidores usam para ter uma resposta (positiva ou negativa) do seu endpoint cadastrado nos webhooks. Passado esse tempo, o pacote de dados será descartado, sem possibilidade de reenvio.
Modelo de objeto JSON enviado ao seu endpoint a cada atualização do qrcode.
Modelo de objeto JSON enviados ao seu endpoint.
Modelo de objeto JSON enviados ao seu endpoint a cada nova mensagem recebida em seu número enquanto sincronizado ao nosso Portal.
Essa API foi desenvolvida utilizando os módulos presentes no e por isso é necessária a sincronização via Qrcode do seu número a uma instância vinculada ao seu usuário em nosso Portal.
Quando a instância está sincronizada ao seu número, você poderá enviar e receber mensagens a destinatários que estejam ou não em sua lista de contatos, receber dados de como Callbacks, DLRs e outros.
Neste momento não disponibilizamos um serviço de API capaz de criar ou editar uma instância. Por isso, é necessário acessar o nosso e criar uma a partir do menu WhatsApp → Instâncias
A sincronização acontece da mesma forma que você faz para acessar o , ou seja, a partir da leitura do Qrcode via aplicativo.
A sessão é iniciada a partir do envio, assim como no recebimento também, de mensagens de contatos ou não contatos que ainda não tenham interação inicializada através do ou , enquanto seu número estiver sincronizado/pareado com a .
Neste momento o WhatsApp não disponibiliza um módulo ou função que permita o compartilhamento da sincronização entre múltiplos dispositivos. Por isso, ao sincronizar o seu número no enquanto estiver conectado ao Portal SMSFire, ou vice-versa, fará com que a sincronização seja encerrada com o nosso sistema.
Atualizações de instância e sincronização não são enviadas por Webhooks. Para receber notificações sobre essas atualizações considere a leitura do item .
Para a impressão do QRCode em ambiente web recomendamos a utilização da biblioteca
Verifique os detalhes sobre mensagens multimídia a partir da seção
