Guia completo do zero ao funcionando. Siga cada parte na ordem certa — leva em média 20 a 40 minutos na primeira vez.
O Gupshup é a plataforma que conecta o seu número ao WhatsApp Business API oficial.
Clique no botão abaixo para abrir a página de cadastro do Gupshup. Preencha seus dados: nome, e-mail, telefone e empresa. Depois confirme o e-mail que você vai receber na caixa de entrada.
Após o login, você estará no Apps Dashboard. Clique em "Create New App" para começar.
Escolha um nome para identificar o app — use o nome da sua empresa ou do canal (ex: MinhaEmpresaWA). Esse nome vai aparecer no painel e será o seu App ID de identificação.
O app vai aparecer na lista do dashboard. Localize-o e clique na opção "Go Live" para iniciar o processo de ativação.
O Gupshup vai pedir informações sobre o seu negócio e o número de telefone que será usado como WhatsApp Business. Preencha todos os campos obrigatórios com atenção.
Na etapa 3 do Go-Live, vai abrir o fluxo embarcado do Facebook. Você vai conectar sua conta do Meta Business Manager e verificar o número de telefone. Siga todas as telas até o fluxo finalizar e retornar ao Gupshup.
Com o Gupshup ativo, agora você instala o conector no seu portal Bitrix24.
Clique no botão abaixo para ir direto à página do app. Você também pode pesquisar por "WhatsApp API Connector Gupshup" dentro do Bitrix24 em Aplicativos → Marketplace.
Abrir no Marketplace do Bitrix24
Na página do app, clique no botão "Instalar". Se você ainda não estiver logado no Bitrix24, o sistema vai pedir login. Selecione o portal onde deseja instalar.
Leia o contrato de licença (EULA) e a política de privacidade. Marque as caixinhas de confirmação e clique em "Instalar" para finalizar.
Após instalar, o app vai abrir a tela de ativação do trial. Clique em "Ativar trial" para liberar os 10 dias gratuitos. O cadastro do cartão é feito via Stripe — a cobrança só ocorre após o término do período de trial.
Aqui você une os dois lados: o Gupshup e o Bitrix24 passam a se comunicar.
No Bitrix24, pesquise por "Contact Center" na barra de busca do menu lateral ou navegue até Mensagens → Contact Center. Clique para abrir.
Dentro do Contact Center, localize o card do WA Business Connector e clique nele.
Escolha o Canal Aberto que você deseja vincular ao número WhatsApp e clique em "Conectar". Uma janela de configuração vai abrir — não feche ela.
Abra o Gupshup em outra aba. No dashboard, clique sobre o card do seu app e depois clique na aba Settings.
Na tela de Settings você verá o campo App ID — um código UUID longo (ex: e203053b-4a19-4680-9b05-8b39d108beec). Clique no ícone de copiar ao lado dele.
Na mesma tela Settings, role para baixo até a seção de chaves e clique em "+ Create API key". No modal que abrir, clique em "Copy API key".
Ainda no Gupshup, clique na aba Account. Localize o campo "Número de telefone" e copie o número no formato internacional.
De volta ao Bitrix24, preencha o formulário do WhatsApp API Connector Gupshup com os dados coletados:
Após preencher, clique em "Salvar" ou "Conectar".
Após salvar, o conector vai exibir a URL de Webhook (Callback URL). Copie essa URL — você vai precisar dela no próximo passo.
No Gupshup, dentro do seu app, clique na aba Webhooks. Cole a URL copiada no campo "Callback URL", selecione a versão API v2 e marque todos os eventos disponíveis. Clique em Save.
Agora é só começar a usar.
Do seu celular pessoal, envie uma mensagem de WhatsApp para o número Business configurado. Em 5 a 15 minutos ela deve aparecer no Contact Center → Conversas do Bitrix24.
Responda pelo Bitrix24 e confirme que a mensagem chega de volta no celular — a conexão nos dois sentidos está funcionando.
A partir de agora seu time já pode receber mensagens, responder clientes e enviar templates HSM — tudo direto no Bitrix24. Bom atendimento!
