Снятие тегов у лидов и сделок

Читать 3

Описание

В статье описан API метод снятия тегов у лидов и сделок.

Запрос

Поддерживаемый метод отправки: GET.

API-запрос:

https://api.calltouch.ru/calls-service/RestAPI/{site_id}/deletetags/
Где:
  • {site_id} — ID вашего сайта внутри ЛК Calltouch. Указывается без фигурных скобок. Его можно получить в разделе:  Интеграции /   Отправка данных во внешние системы / API и Webhooks.

Пример API-запроса на удаление тега у лида

Запрос далее снимет теги "тег1" и "тег2" со звонка с ID=1074902 на сайте с ID=123:

https://api.calltouch.ru/calls-service/RestAPI/123/deletetags/?clientApiId=321&callId=1074902&tagnames=тег1,тег2

Параметры запроса

Параметр Описание
clientApiId
Ключ доступа к API, его можно получить в меню личного кабинета Calltouch в разделе:  Интеграции / Отправка данных во внешние системы / API и Webhooks / API / API токен (access_token).

callId 
или
requestId
или
requestNumber
или
orderId
или
orderNumber

Теги можно удалять у звонков,  заявок или сделок. В зависимости от того, откуда именно вы хотите удалить теги, необходимо использовать параметр:

  • callId - ID звонка в Calltouch. Идентификатор любого звонка можно узнать с помощью API-выгрузки звонков.
  • requestId - ID заявки в Calltouch. Идентификатор любой заявки можно узнать с помощью API-выгрузки заявок.
  • requestNumber - ID заявки с сайта.
  • orderId - ID сделки в Calltouch. Идентификатор любой сделки можно узнать с помощью API-выгрузки сделок.
  • orderNumber - ID сделки из CRM
tagnames Теги через запятую, которые нужно снять со звонка, заявки или сделки. Можно удалять теги, присвоенные не только через API, но и любым другим способом. При снятии тега, он не удаляется из списка тегов. Указывая несколько тегов, после запятой не нужно ставить пробел, иначе он окажется началом следующего тега. 

Система баллов API

Система баллов API — механизм, регулирующий нагрузку на сервера Calltouch. Для каждого проекта выдается индивидуальное суточное количество баллов. За каждый успешно выполненный запрос списываются баллы. Подробнее читайте в статье: Система баллов API Calltouch.

Количество запросов в секунду к API Calltouch ограничено — не более 5 запросов в секунду с одного IP-адреса. Например, если в 1 секунду с одного IP-адреса поступит 11 API-запросов, то 5 выполнятся сразу, а остальные API-запросы завершатся с ошибкой c кодом 429 (Too Many Requests).

Не нашли решение проблемы?
Заполните форму, и мы вам поможем.