Navegar na CentralLinks de setup

Links de setup

Gere um link para o seu cliente conectar o WhatsApp ou o Instagram dele sozinho, acompanhe se ele concluiu e revogue links que não devem mais funcionar.

Atualizado em

Um link de setup é uma página de conexão pronta para o seu cliente. Você gera o link aqui, manda para ele, e ele mesmo autoriza a conexão, sem precisar te passar senha. Cada link conecta um canal: o WhatsApp, na janela oficial da Meta, ou o Instagram, no login do Instagram. Quando ele termina, o número ou a conta aparece no cliente certo do seu workspace. Para o cliente conectar os dois, gere um link de cada.

É o caminho ideal para agências e para quem conecta o WhatsApp de outra pessoa.

A tela fica em Configurações › Links de setup. Também dá para chegar pelo botão Gerar link de setup, em Canais.

Antes de começar

  • Cadastre o cliente em Configurações › Clientes. Sem cliente, a janela mostra Cadastre um cliente primeiro para gerar um link de setup. Veja Clientes.
  • Confira os negócios do plano. O topo da tela mostra, por exemplo, Em uso 1 de 1 negócio, contando o negócio incluído no plano e os slots adicionais. No plano pago, um cliente que ainda não tem canal conectado (número de WhatsApp ou conta do Instagram) e passa do que o plano inclui ocupa um slot vazio, se houver; senão, ganha um slot adicional de R$ 47 por mês, com a 1ª fatura em 3 dias. Veja Plano e cobrança.
  • No teste grátis, com o negócio do teste em uso, a tela e a janela do link avisam: Seu teste comporta 1 negócio e ele já está em uso. Um cliente que ainda não tem WhatsApp conectado só consegue concluir o link depois que você assinar um plano. O link Ver plano leva para a parte de negócios da tela Plano.
  • Pela API ou pelo MCP, cada link de setup diz o que vai acontecer com a cobrança quando o cliente conectar: nada a mais, usar um slot vazio que você já tem, criar um slot de R$ 47 por mês ou não conectar por um dos motivos abaixo.
  • A conexão de um cliente novo é recusada só quando ele não pode ganhar um slot: no Free ou no teste grátis (é preciso assinar o plano), com 2 slots com fatura vencida ou não paga (é preciso pagar uma delas) e em conta sem cobrança cadastrada, como a cortesia. Nesses casos, a página do link já abre avisando, antes da janela da Meta ou do login do Instagram: Conexão indisponível por enquanto, com Este negócio ainda não pode ser conectado por este link. e o pedido para avisar você, pelo nome do seu workspace. O botão de conectar não aparece, e o seu cliente não chega a autorizar nada. Como no resto da página, o topo mostra a sua logo e o texto não fala de plano nem do BotoZap. Resolva o motivo e peça para ele abrir o mesmo link de novo.

Passo a passo

  1. Clique em Novo link de setup.

  2. No topo da janela, escolha o canal: WhatsApp (vem escolhido) ou Instagram.

  3. Em Cliente, busque e clique no cliente que vai conectar.

  4. No WhatsApp, marque em Modos de conexão os modos que o cliente pode escolher:

    • Só pelo BotoZap: o número passa a funcionar só pelo BotoZap, sem o aplicativo no celular. É para um número que ainda não está no WhatsApp. Vem marcado.
    • Com o app no celular: o cliente continua usando o aplicativo WhatsApp Business no celular e atende também pelo BotoZap, com o mesmo número.

    Se você marcar os dois, o cliente escolhe na página. Veja Conectar o seu WhatsApp.

    No Instagram não há modos: no lugar deles, a janela lembra que o cliente entra com a conta profissional do Instagram da empresa, sem precisar de Facebook.

  5. Clique em Criar e copiar link do WhatsApp ou Criar e copiar link do Instagram.

O link já vai para a área de transferência e aparece Link criado e copiado. Mande para o seu cliente pelo canal que preferir. O link vale por 30 dias.

Redirecionamentos (opcional)

Se o link for aberto a partir de um sistema seu, abra Redirecionamentos (opcional) e preencha a URL de sucesso e a URL de falha. Quando o cliente conclui, ele volta para a URL de sucesso. Vale para os dois canais. Se desistir, ou se a conexão falhar e o link se esgotar, ele vai para a URL de falha. Quem abrir depois um link do WhatsApp vencido, revogado ou já usado vê Link indisponível, sem redirecionamento. Os endereços precisam começar com https://. Quem não tem um sistema próprio pode deixar em branco.

Cor da página (opcional)

Para a página do link ficar com a cor da sua marca, abra Cor da página (opcional) e escolha a cor no círculo ou cole o código dela no campo Cor da sua marca, no formato #RRGGBB (por exemplo, #0A66C2). Abaixo aparece a prévia do selo e do botão da página. A cor vale para os dois canais e só para o link que você está criando. Em branco, a página fica com a cor padrão. Pela API, a mesma cor vai em theme_config.primary_color, e dá para trocar ou tirar a cor de um link que já existe.

O que o seu cliente vê

A página do link leva a sua marca, não a do BotoZap. No topo aparece a logo do seu workspace (a Logo (URL) de Configurações, se começar com https://). Sem logo, o topo fica vazio. Com uma cor escolhida no link, os botões, os links e os destaques da página saem nessa cor, no tema claro e no escuro do celular do cliente. Se a cor for clara ou escura demais para ler em algum dos temas, a página escurece ou clareia o tom só o necessário para o texto ficar legível. A página não tem rodapé, e o título e a prévia do link, quando você manda pelo WhatsApp, dizem só Conectar WhatsApp ou Conectar Instagram.

Abaixo da logo vêm Conecte seu WhatsApp Business, o nome da empresa dele e o do seu workspace, e uma lista do que ter à mão: uma conta do Facebook com permissão para administrar a empresa, o celular com o WhatsApp que ele quer conectar e acesso ao telefone para as instruções de verificação.

Se você liberou os dois modos, ele vê um só caminho, Conectar meu número, e a Meta reconhece o caso pelo número digitado. Se liberou um só, o modo aparece em Como você quer conectar: Com o app no celular ou Sem o app no celular (o nome que o cliente vê para Só pelo BotoZap). Ele aceita a política de mensagens da Meta e clica em Conectar WhatsApp. Antes de a janela abrir, a página mostra as três telas que a Meta vai exibir e pergunta Você tem Facebook?. Quem responde que não tem recebe o link para criar a conta. Depois ele conclui a janela da Meta. A página lembra que ninguém além da Meta vê a senha do WhatsApp ou do Facebook dele.

Se o número ficou com o app no celular, a página pergunta em seguida Trazer as conversas antigas?: Não trazer, Último mês (já marcado) ou Últimos 6 meses, com Confirmar. Se você configurou um redirecionamento de sucesso, ele acontece depois da resposta. Se o cliente fechar a página sem responder, a mesma pergunta aparece para você em Configurações › Canais, e sem resposta vale o último mês. Veja Conversas antigas do app WhatsApp Business.

Se algo der errado, a página orienta o próximo passo e, quando ele precisa de ajuda, diz Se precisar de ajuda, fale com quem enviou este link. Ela não mostra o suporte do BotoZap ao seu cliente. Recusas que só você resolve, como capacidade do plano ou número já conectado em outra conta, aparecem para ele como um pedido para avisar você.

A janela de autorização é da Meta, e ela mostra a empresa aprovada pela Meta para fazer a conexão: Bytecraft, como em Conecte sua conta facilmente a Bytecraft. Se a janela fechar sem concluir, a página mostra o que fazer: na tela de login do Facebook, entrar, fechar a janela da Meta e clicar em Tentar de novo (a janela que passa pelo login não devolve a conexão à página), com os caminhos para criar a conta ou recuperar a senha; depois do login, a pergunta Em qual tela a janela fechou?, com as imagens das telas. O endereço da página continua no domínio do BotoZap.

O endereço do link do Instagram termina em /instagram/setup/ e a página fala só do Instagram. Abaixo da logo vêm o selo Conexão segura, Conecte o seu Instagram, o nome da empresa dele e o do seu workspace, e o aviso de que ele entra com a conta dele do Instagram e que nada é publicado no perfil.

Em Antes, confirme duas coisas, ele marca:

  • A conta é profissional: Comercial ou Criador de conteúdo, com o caminho no app para conferir.
  • As mensagens estão liberadas: o caminho até Permitir acesso a mensagens no app do Instagram. Sem isso, a conexão até acontece, mas os directs não chegam.

O botão Entrar com o Instagram só funciona com as duas marcadas. Abaixo, o quadro O que você permite lista o acesso pedido: ler e responder as mensagens do Direct, responder comentários dos posts e ver o nome e a foto do perfil. A janela do Instagram mostra o nome do aplicativo, BotoZap. Os pré-requisitos estão em Conectar e atender pelo Instagram.

Ao voltar para a página, ele vê o resultado:

  • Instagram conectado, com a foto e o @ da conta e Os directs desta conta já chegam para o nome do seu workspace. A conta aparece em Configurações › Canais, na tabela Instagram do cliente do link. Se você preencheu a URL de sucesso, ele vai direto para ela.
  • O Instagram foi autorizado, com o pedido para avisar você. A conta ficou Pendente: abra Canais, escolha o cliente e clique em Tentar novamente na linha da conta.
  • Conexão cancelada ou Não deu para conectar, com Tentar de novo. Se você preencheu a URL de falha, aparece também o link para voltar ao seu sistema.
  • Este negócio já tem um Instagram. Cada cliente aceita uma conta do Instagram. Para conectar outra, crie um cliente novo e gere um link para ele.

Os links criados antes da separação por canal são do WhatsApp e não mostram mais o botão do Instagram. Para o Instagram, gere um link do Instagram.

A lista mostra cada link com:

  • Cliente
  • Canal: WhatsApp ou Instagram. No WhatsApp, embaixo, os modos liberados: Só pelo BotoZap, Com o app no celular ou Os dois modos
  • Status: Ativo, Usado, Expirado ou Revogado. Usado é o link do WhatsApp que já foi usado numa conexão, com Setup Concluído ou Falhou: ele não conecta mais
  • Setup: o andamento da conexão: Pendente, Em andamento, Concluído ou Falhou
  • Criado e Expira

Os chips Todos, WhatsApp e Instagram separam os links por canal e mostram quantos há em cada um. Ao lado, os filtros Todos, Ativos, Usados, Expirados e Revogados recortam por status.

Use Copiar link, na própria linha, para mandar de novo. O link Usado não tem Copiar link: para conectar o número outra vez, gere um link novo.

Se o link foi para a pessoa errada ou não deve mais ser usado:

  1. Clique no botão de três pontos da linha, ao lado de Copiar link, e em Revogar.
  2. Confirme em Revogar link.

O link para de funcionar na hora. Não dá para desfazer: se precisar, gere outro. Só links ativos podem ser revogados.

O que acontece depois

  • Quando o cliente conclui, o Setup do link passa a Concluído e o número aparece em Configurações › Canais, com o cliente escolhido no seletor do topo. Veja Canais.
  • O link do WhatsApp conecta uma vez só. Depois de Concluído ou Falhou, quem abrir o link de novo vê Link indisponível. Para conectar o número outra vez, por exemplo depois de ele ser desconectado, gere um link novo.
  • No link do Instagram, o Setup passa a Concluído quando a conta conecta, e ela aparece na tabela Instagram da mesma tela Canais.
  • Os links de reconexão criados pelo botão Reconectar, em Canais, também aparecem nesta lista.

Problemas comuns

O cliente vê "Link indisponível". O link expirou, foi revogado ou já foi usado. Gere um link novo e mande de novo.

O botão Criar e copiar link não habilita. Escolha um cliente na lista.

Aparece "Escolha pelo menos um modo de conexão." No link do WhatsApp, marque ao menos um dos modos.

O Instagram conectou, mas os directs não chegam. O cliente precisa ligar Permitir acesso a mensagens no app do Instagram (Configurações e privacidade › Mensagens e respostas a stories › Ferramentas para mensagens). Veja Conectar e atender pelo Instagram.

O campo da cor fica vermelho e o link não é criado. A cor precisa estar no formato #RRGGBB: o # e seis caracteres, que podem ser números de 0 a 9 ou letras de A a F (por exemplo, #0A66C2). Escolha a cor no círculo ou deixe o campo em branco para usar a cor padrão.

Aparece "Informe URLs de redirecionamento válidas". As URLs precisam começar com https:// e não podem ter usuário e senha. Se não usa redirecionamento, deixe os campos em branco.

O cliente viu "Conexão indisponível por enquanto" ao abrir o link. A conta está no Free ou no teste grátis, tem 2 slots adicionais com fatura em aberto ou não tem cobrança cadastrada. Vale para o WhatsApp e para o Instagram: o primeiro canal de um cliente ocupa um negócio. Assine o plano ou pague uma das faturas em Configurações › Plano e peça para o cliente abrir o link de novo. Se o link não estiver mais ativo, gere outro.