Подробнее про логику работы интеграции Agora с Битрикс 24 рассказано в видео:

Создание интеграции

Для настройки интеграции перейдите в раздел Интеграция с Bitrix24 → Настройки интеграции административной панели Agora.

Откроется окно настройки, в которое нужно внести данные. 

В поля Портал Битрикс24, ID администратора и Ключ вебхука должны быть вставлены части URL-адреса входящего вебхука, созданного в Битрикс24.

Чтобы создать новый вебхук в Битрикс24, перейдите в раздел Приложения → Разработчикам → Другое → Входящий вебхук.

В открывшемся окне скопируйте URL-адрес вебхука из поля Вебхук для вызова rest api (он будет использоваться в дальнейшей настройке интеграции) и выберите права CRM.

По завершении настроек Сохраните изменения.

Вернитесь в административную панель проекта Agora.

Скопированный ранее URL необходимо разбить на 3 части и вставить в разные поля:

1. до цифры (включая символ «/») — в Портал Битрикс24;
2. цифру — в ID администратора;
3. оставшуюся часть (без символа «/») — в поле Ключ вебхука.

Затем установите или оставьте пустым чекбокс Отправлять вебхук о регистрации пользователя, выберите Статус создания лида и Статус создания сделки — при каких статусах заказа в Agora будет создаваться лид и сделка в Битрикс24.

Поле Код поля ИНН в Bitrix24 является необязательным. Чтобы его заполнить, нужно найти ID поля ИНН в своем Битриксе.

Для этого:

• перейдите в раздел CRM → Настройки →  Настройки CRM → Настройки форм и отчетов → Пользовательские поля → Лид (Список полей);
• в списке найдите поле ИНН и перейдите в него;
• в поисковой строке, в конце url, вы увидите значение UF_CRM_XXXXXXXXXX, где UF_CRM_XXXXXXXXXX — это и есть ID;
• скопируйте его.

Image RemovedImage Added

Вставьте полученное значение в поле Код поля ИНН в Bitrix24, сохраните изменения.

Теперь интеграция Agora с Битрикс24 может считаться завершенной. Вебхук остается доступным до тех пор, пока не будет удален администратор, его создавший.

Журнал запросов

Раздел отображает историю взаимодействий REST API Битрикса с системой Agora. Чтобы перейти в него, кликните по кнопке Журнал запросов в административной панели Agora.

В таблице, которая откроется, вы увидите столбцы:

• ID — номер запроса;
• Дата отправки;
• Дата ответа;
• Тип объявления — например, заказ или регистрация;
• Ссылка на покупателя — в случае создания нового пользователя в столбце появится ссылка с названием Перейти в профиль покупателя;
• Ссылка на заказ — при типе обращения Заказ в поле будет отображаться ссылка Перейти в заказ.
• Лог запроса — подробная информация о запросе;
• Статус — с ошибкой или без нее был обработан запрос.

Image Modified

Если кликнуть по ID запроса, вы попадете на страницу с детальной информацией по запросу.

Также в таблице есть возможность выбрать несколько запросов и удалить их.

Create an integration

To set up the integration, go to the Integration with Bitrix24 → Integration 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 settings → Form and report settings → Custom Fields → Lead (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.

Image Modified

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

Image Modified

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

Image Modified

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.

Image RemovedImage Added

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

Image Modified

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.

Image Added

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

• ID — número de solicitação;
• Data de expediçãoA data da partida;
• Data de resposta;
• Tipo de anúncioReclamação — como pedido ou registro;
• Link 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.
• Registro Log de solicitação — informações detalhadas sobre a solicitação;
• Status — com ou sem erro, a solicitação foi processada.

Image Added

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

Image Added

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

Image Added