Você tem um programa de indicações rodando. Os clientes indicam, os leads chegam, mas chegam num lugar errado, ou chegam sem origem, ou chegam tarde. Vendedor não sabe que aquele lead veio de uma indicação que vai gerar comissão pra alguém. Resultado: o indicador nunca recebe, para de indicar, e você perde o melhor canal de aquisição que tem.

A correção é técnica e relativamente simples: integrar o sistema de indicações ao seu CRM (no caso, o Bitrix24), pra que cada lead chegue no funil correto, com origem rastreada e comissão pré-calculada. Esse tutorial mostra como fazer isso passo a passo.

Quem é esse tutorial pra: gestor comercial ou de operações em provedor de internet (ou empresa B2C com base recorrente) que já usa Bitrix24 e quer estruturar um programa de indicações. Não precisa ser desenvolvedor, basta conhecer o Bitrix24 minimamente.

Por que integrar (e por que dói não integrar)

Sem integração, o fluxo típico é: o cliente recebe um link de indicação, manda pra um amigo, o amigo preenche um formulário, e o lead vai parar numa planilha. Toda manhã (ou toda semana) alguém abre essa planilha, copia os contatos pra o Bitrix24 manualmente, escreve no campo Origem "indicação", e segue a vida.

Os 4 problemas que isso cria:

A integração resolve todos os 4. Não com mágica, mas com webhook em tempo real + campos personalizados padronizados. É o que vamos configurar agora.

Pré-requisitos

Passo 1: Criar webhook de entrada no Bitrix24

O webhook de entrada é a "porta" pela qual sistemas externos vão criar registros no seu Bitrix24. É uma URL única, secreta e autenticada que aceita chamadas HTTP e cria leads, contatos ou negócios.

Pra criar:

  1. Logue no Bitrix24 como administrador
  2. Vá em Apps → Aplicativos web → Webhook entrada (em alguns planos: Devops → Outros → Webhook entrada)
  3. Clique em Adicionar webhook
  4. Em "Atribuir permissões", marque pelo menos: crm (criar negócios e contatos)
  5. Salve. Vai aparecer uma URL no formato:
# Cloud
https://SEU-DOMINIO.bitrix24.com.br/rest/USER_ID/TOKEN_SECRETO/

# Self-hosted
https://crm.SEU-DOMINIO.com/rest/USER_ID/TOKEN_SECRETO/
⚠️ Tratamento de segredo: essa URL contém um token secreto. Quem tem essa URL pode criar negócios no seu CRM. Não compartilhe em GitHub público, em prints sem mascarar, ou em chats não criptografados.

Passo 2: Criar campos personalizados

Os campos padrão do Bitrix24 (nome, telefone, e-mail) já existem. Mas a indicação carrega dados extras que precisam de campos próprios. Sem isso, o vendedor não vê quem indicou nem o valor da comissão.

Vá em CRM → Configurações → Campos personalizados → Negócio e crie:

Nome do campoTipoSímbolo
Indicador (Nome)TextoUF_INDICADOR_NOME
Indicador (Código)TextoUF_INDICADOR_CODIGO
Comissão PIXDinheiroUF_COMISSAO_PIX
UTM SourceTextoUF_UTM_SOURCE
URL de rastreioURLUF_INDICACAO_URL

Depois de criar, esses campos vão aparecer no card de cada negócio. O vendedor abre, vê "Indicado por João S., comissão R$ 35", e o contexto fica óbvio.

Passo 3: Mapear pipeline e responsável

Decida em qual estágio do funil o lead de indicação deve cair:

E em qual responsável atribuir:

Anote o ID do estágio e do usuário que vai receber o lead. Você vai precisar disso no próximo passo.

Passo 4: Conectar o sistema de indicações

Agora a parte que conecta: configurar o seu sistema de indicações pra disparar uma chamada HTTP POST pro webhook do Bitrix24 toda vez que uma indicação for criada.

O payload típico é JSON e fica assim:

POST https://SEU-DOMINIO.bitrix24.com.br/rest/USER_ID/TOKEN/crm.deal.add.json

{
  "fields": {
    "TITLE": "Maria Clara S. (indicada por João S.)",
    "STAGE_ID": "NEW",
    "ASSIGNED_BY_ID": "7",
    "SOURCE_ID": "INDICACAO",
    "UF_INDICADOR_NOME": "João Silva",
    "UF_INDICADOR_CODIGO": "U-1042",
    "UF_COMISSAO_PIX": "35.00",
    "UF_UTM_SOURCE": "whatsapp",
    "UF_INDICACAO_URL": "https://fazup.com.br/r/IND-4821",
    "PHONE": [{ "VALUE": "+5547999887766", "VALUE_TYPE": "WORK" }],
    "EMAIL": [{ "VALUE": "maria@email.com", "VALUE_TYPE": "WORK" }]
  }
}

No FazUp, esse payload é gerado e enviado automaticamente. Você só cola a URL do webhook no painel admin e mapeia os IDs dos seus campos. Não precisa escrever uma linha de código.

Quer pular essa parte?

A equipe FazUp configura tudo pra você em 24h, sem custo adicional. Você só autoriza e valida.

Falar com a equipe

Passo 5: Testar end-to-end

Antes de ativar pros indicadores reais, faça um teste completo simulando uma indicação:

  1. Crie um indicador fake no seu sistema de indicações (ex: "João Teste", código U-TESTE-01)
  2. Acesse o link de indicação dele
  3. Preencha o formulário com dados de teste (use seu próprio telefone pra receber a notificação)
  4. Vá no Bitrix24 e confira:

Se algum item falhar, vá pro próximo seção (troubleshooting).

Troubleshooting comum

"O webhook retorna erro 401 (Unauthorized)"

Token errado ou usuário sem permissão. Confira que o webhook tem permissão de crm ativada e que a URL está completa (incluindo o trailing slash).

"O negócio é criado mas os campos personalizados ficam vazios"

O nome do campo (UF_*) está incorreto. Vá em CRM → Configurações → Campos personalizados e copie o "Nome simbólico" exato. Diferencia maiúsculas e minúsculas.

"Lead duplicado quando o cliente indicado já existia"

Por padrão, o Bitrix24 não checa duplicidade. Use crm.duplicate.findbycomm antes de crm.deal.add pra detectar e vincular ao contato existente. O FazUp faz isso automático.

"Webhook funciona mas o lead chega 5 minutos depois"

Provavelmente seu sistema de indicação tá usando fila batch em vez de envio em tempo real. Confira na configuração do webhook de saída se a opção é "imediato" e não "agrupado".

FAQ

Preciso ser admin do Bitrix24 pra fazer essa integração?

Sim, é necessário ser administrador ou ter um usuário com permissão pra criar webhooks de entrada e modificar campos personalizados de negócios. Se você não for admin, peça que o admin gere o webhook e te envie a URL.

Funciona com Bitrix24 cloud (.com.br) e self-hosted?

Sim. A integração funciona em ambas as versões. A diferença é só a URL do webhook, que muda conforme o domínio da sua instância.

O que acontece se o lead já existir no Bitrix24?

O FazUp consulta antes de criar e, se encontrar um contato com mesmo telefone ou e-mail, cria um novo NEGÓCIO vinculado ao contato existente, em vez de duplicar. Isso preserva o histórico do cliente.

Quanto tempo o webhook leva pra ser configurado?

Em média 30 minutos pra configurar do zero. Pela equipe FazUp, o processo completo (configuração + testes + validação) leva 24h.

Pronto. Com esses 5 passos seu Bitrix24 deixa de ser uma planilha digital e vira um motor real de programa de indicações: cada lead chega rastreado, com comissão calculada e indicador identificado.

Se quiser ver como o produto que faz tudo isso funciona na prática, dá uma olhada na página de integração Bitrix24 do FazUp ou na visão geral do FazUp Indicações.