Guia de Configuração Bitrix24

Voltar
Como obter a URL do Webhook
Importante: A URL do webhook deve ser criada no seu portal Bitrix24.
Passo a passo:
  1. Acesse seu Bitrix24:
    Entre no seu portal (ex: https://seudominio.bitrix24.com.br)
  2. Vá para Aplicações:
    Menu principal → Aplicações → Webhooks
  3. Crie um Webhook de Entrada:
    Clique em "Adicionar webhook" → "Webhook de entrada"
  4. Configure as Permissões:
    Marque as seguintes permissões:
    • CRM (Leitura)
    • CRM (Escrita)
    • Negócios
  5. Copie a URL:
    Após salvar, copie a URL completa gerada
Formato Correto da URL

A URL do webhook deve seguir este formato:

https://seudominio.bitrix24.com.br/rest/ID_USUARIO/CODIGO_WEBHOOK/
✓ Exemplos Corretos:
  • https://exemplo.bitrix24.com.br/rest/1/abc123def456/
  • https://minhaempresa.bitrix24.com/rest/42/xyz789/
✗ Exemplos Incorretos:
  • script.bitrix24.com.br/rest/... (sem https://)
  • https://bitrix24.com/rest/... (domínio errado)
Problemas Comuns

Possíveis causas:
  • URL do webhook incorreta ou incompleta
  • Webhook não criado no Bitrix24
  • Portal Bitrix24 inacessível
  • Problemas de conexão com a internet
Soluções:
  • Verifique se a URL está completa e correta
  • Teste acessar seu portal Bitrix24 no navegador
  • Recrie o webhook no Bitrix24

Possíveis causas:
  • Webhook desabilitado ou excluído
  • Permissões insuficientes
  • Usuário sem acesso ao CRM
Soluções:
  • Verifique se o webhook ainda existe no Bitrix24
  • Confira as permissões do webhook
  • Teste com outro usuário administrador

Possíveis causas:
  • URL do webhook incorreta
  • Domínio do portal errado
  • ID ou código do webhook inválido
Soluções:
  • Copie novamente a URL do webhook
  • Verifique o domínio do seu portal
  • Recrie o webhook se necessário
Precisa de Ajuda?

Se ainda tiver problemas, verifique:

  • Documentação oficial do Bitrix24
  • Suporte técnico do seu portal
  • Configurações de firewall/proxy
Teste Manual

Para testar manualmente, acesse no navegador:

SUA_URL_WEBHOOK/crm.deal.list

Deve retornar dados JSON se estiver funcionando.