Como conectar e gerenciar números de WhatsApp na Grapnel

O que é uma conexão de WhatsApp na Grapnel?

Uma conexão, também chamada de instância no painel, associa um número de WhatsApp à Grapnel. Cada conexão contratada corresponde a um número. A equipe continua conversando pelo WhatsApp, enquanto a Grapnel organiza os números, distribui a entrada de contatos e oferece recursos de integração.

A contratação pode ser mensal ou anual, de acordo com a quantidade de conexões. Os valores atuais aparecem na página inicial e nas condições do painel ao contratar. Criar a conta é a etapa de acesso; para conectar os números, escolha o plano e conclua a contratação.

Como conectar um número pelo QR Code

Use o WhatsApp do número que deseja conectar. Antes de iniciar, confirme qual vendedor ou setor ficará responsável por ele e se você tem autorização para associar esse número à conta da equipe.

1. Crie e confirme a conta da Grapnel e contrate as conexões necessárias.
2. No painel WhatsApp, localize a instância e abra a ação para conectar.
3. No WhatsApp do celular, abra Aparelhos conectados e use a opção de conectar um aparelho.
4. Escaneie o QR Code exibido no painel e aguarde a confirmação da conexão.
5. Confira o número associado e o estado conectado antes de incluí-lo nos links da equipe.

Como organizar os números da equipe

Use nomes que ajudem a identificar o destino, como Vendas — Ana ou Suporte — Loja. As etiquetas permitem agrupar instâncias conforme a organização da operação. No painel, os números e seus estados de conexão ajudam a reconhecer quais conexões precisam de atenção.

Nome e etiqueta identificam a instância; a participação em um link depende da configuração daquele link. Ao trocar um vendedor ou reorganizar a equipe, confira os destinos e pesos dos links existentes. Assim você evita divulgar uma campanha com um número que não deveria mais receber novos contatos.

Como funcionam os avisos de desconexão

Se um número perder a conexão inesperadamente, a Grapnel pode enviar um e-mail ao proprietário da conta, conforme as preferências de notificação. O aviso identifica a instância e oferece um link para acessar o painel e reconectá-la.

O e-mail ajuda a perceber a desconexão, mas a verificação deve ser feita no painel. Confira qual número perdeu a conexão e, quando solicitado, escaneie um novo QR Code. Depois da reconexão, confirme o estado da instância e teste os fluxos que dependem dela.

Uma desconexão interrompe todos os links?

O comportamento depende da configuração de cada link. Quando os números estão fixados, a Grapnel pode continuar abrindo a conversa no número salvo mesmo com a instância offline. Abrir o WhatsApp desse número e manter a conexão da Grapnel ativa são situações distintas.

Quando a distribuição usa somente instâncias conectadas, um número offline deixa de atender esse critério. Se não houver destino elegível, o fallback configurado serve como alternativa. Confira as opções Fixar números das instâncias, participantes ativos e Número de fallback para entender o resultado do seu link.

Integrações, envio de mensagens e atribuição dependem das condições do fluxo e da conexão. Não use apenas o fato de o link abrir uma conversa como comprovação de que todos os recursos da instância estão funcionando.

O que exige programação?

Conectar números e configurar links pelo painel não exige programação. Para integrar sistemas externos, a Grapnel oferece uma API pública documentada, com permissões específicas para os recursos acessados. Mantenha chaves de API no servidor e conceda apenas as permissões necessárias à integração.

Pedidos, lembretes, bots e pesquisas de pós-venda podem fazer parte de um fluxo externo integrado à API. Os gatilhos, horários e regras desses fluxos são configurados na ferramenta de automação utilizada pela equipe. Antes de operar, confira os endpoints, respostas e requisitos na documentação da API.