Дерево страниц

Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Sv translation
languageen
Информация
iconfalse

Set up integration with Bitrix24 using this guide. The CRM mode in Bitrix24 must be set to classic (Leads + Deals).

Оглавление

Create an integration

To set up the integration, go to the Integration with Bitrix24Integration settings section of the Agora administrative panel.

A settings window will open in which you need to enter data.

Parts of the incoming webhook URL created in Bitrix24 should be inserted into the Bitrix24 Portal, Administrator ID and Webhook Key fields.

To create a new webhook in Bitrix24, go to Applications → Developer resources→ Other → Inbound webhook.

In the window that opens, copy the webhook URL from the field  Webhook to call the rest api (it will be used in further integration settings) and select CRM rights.

After completing the settings, Save the changes.

Return to the admin panel of the Agora project.

The previously copied URL must be broken into 3 parts and pasted into different fields:

  • up to a number (including the «/» symbol) — to the Bitrix24 Portal;
  • number — in the Administrator ID;
  • the rest (without the «/» symbol) — in the Webhook key field.

Then check or leave empty the Send a webhook about user registration checkbox, select Lead creation status and Transaction creation status — at what order statuses in Agora the lead and deal will be created in Bitrix24. 

The field TIN field code in Bitrix24 is optional. To fill it out, you need to find the TIN field ID in your Bitrix.

For this:

  • go to CRM Settings CRM settingsForm and report settingsCustom FieldsLead (Fields);
  • find the TIN field in the list and go to it;
  • in the search bar, at the end of the url, you will see the value UF_CRM_XXXXXXXXXX, where UF_CRM_XXXXXXXXXX is the ID;
  • copy it.

Image RemovedImage Added

Paste the received value into the field TIN field code in Bitrix24, save the changes.

Now the integration of Agora with Bitrix24 can be considered complete. The webhook remains available until the administrator who created it is deleted.

Query Log

The section displays the history of Bitrix REST API interactions with the Agora system. To access it, click on the Query Log button in the Agora administration panel.

In the table that opens, you will see the columns:

  • ID — request number;
  • Shipping date;
  • Response date;
  • Type of appeal — for example, order or registration;
  • Link to the buyer — if a new user is created, a link with the name Go to the buyer's profile will appear in the column;
  • Link to the order — if the case type is Order, the field will display the Go to order link.
  • Request type — detailed information about the request;
  • Status — the request was processed with or without an error.

Clicking on a request ID will take you to a page with detailed information about the request.

It is also possible to select multiple queries in the table and delete them.

Примечание
iconfalse

If you have any questions about setting up your project, please contact Agora technical support.

Sv translation
languagept_BR
Информация
iconfalse

Configure integração com Bitrix24 usando este tutorial. O modo CRM no Bitrix24 deve ser definido como clássico (Leads + Deals).

Оглавление

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 desenvolvedoresOutros 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 CRMConfigurações de Formulário e RelatórioCampos PersonalizadosLead (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;
  • A data da partida;
  • Data de resposta;
  • Tipo de Reclamação — como pedido ou registro;
  • Referência 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.
  • Log 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.

Примечание
iconfalse

Se você tiver alguma dúvida sobre a configuração do seu projeto, entre em contato com o Suporte Técnico da Agora.