Crie uma integração

Crie uma integração

Para configurar a integração, acesse a seção Integração com Bitrix24 → seção Configurações de Integração do painel administrador do Agora.

Uma janela de configuração será aberta, na qual você precisa inserir os dados.

Nos campos do Portal Bitrix24, ID do administrador e do Webhook Key, partes da URL do webhook de entrada criado no Bitrix24 devem ser inseridas.

Para criar um novo webhook no Bitrix24, acesse Aplicativos → Recursos para desenvolvedores → Outros → Webhook de entrada.

Na janela que abre, copie a URL do webhook do campo Webhook para API REST de chamada (ela será usada em configuração de integração adicional) e selecione os direitos de CRM.

Quando as configurações estiverem concluídas, salve as alterações.

Retorne ao painel administrativo do projeto Agora.

A URL copiada anteriormente deve ser dividida em 3 partes e colada em diferentes campos:

1. até um número (incluindo o símbolo «/») — para o Portal Bitrix24;
2. o dígito está no ID do administrador;
3. o restante (sem o caractere «/») está no campo Chave do webhook.

Em seguida, defina ou deixe em branco o Enviar um webhook sobre o registro do usuário, selecione Status da criação do lead e Status da criação da transação — no qual os status do pedido agora criarão um lead e um acordo no Bitrix24.

O campo TIN em Bitrix24 é opcional. Para preenchê-lo, você precisa encontrar a Código do campo Tin em Bitrix24.

Para fazer isso:

• vá para CRM → Configurações → Configurações de CRM → Configurações de Formulário e Relatório → Campos Personalizados → Lead (Campos);
• na lista encontrar o campo TIN e ir para ele;
• na barra de pesquisa, no final da url, você verá o valor do UF_CRM_XXXXXXXXXX, onde UF_CRM_XXXXXXXXXX é o ID;
• copiá-lo.

Cole o valor resultante no campo de código de campo Código do campo Tin em Bitrix24, salvo as alterações.

A integração da Agora com o Bitrix24 agora pode ser considerada completa. O webhook permanece disponível até que o administrador que o criou seja excluído.

Registro de consulta

A seção exibe o histórico de interações da API Bitrix REST com o sistema Agora. Para acessá-lo, clique no botão Solicitar log no painel administrativo do Agora.

Na tabela que abre, você verá as seguintes colunas:

• ID — número de solicitação;
• Data de expedição;
• Data de resposta;
• Tipo de anúncio — como pedido ou registro;
• Link do comprador — se você criar um novo usuário, um link aparecerá na coluna com o nome Ir para o perfil do comprador;
• Link de pedido — se digitar «Pedir», o link «Ir à Ordem» será exibido no campo.
• Registro de solicitação — informações detalhadas sobre a solicitação;
• Status — com ou sem erro, a solicitação foi processada.

Se você clicar no ID de solicitação, você será levado para uma página com informações detalhadas sobre a solicitação.

Também na tabela há a oportunidade de selecionar várias consultas e excluí-las.