Sasha AI предоставляет возможность автоматической загрузки контактов в колл-листы через API интеграции. Это позволяет разработчикам настроить автоматическую передачу данных контактов из внешних систем (AmoCRM, Bitrix, API, и т.п.)

​
Типы интеграций

В системе поддерживаются два типа интеграций:

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

1

Выбор колл-листа

В интерфейсе платформы выберите колл-лист
2

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

Нажмите “Создать интеграцию”
3

Заполнение полей

Заполните необходимые поля:
  • Название
  • Описание (опционально)
  • Тип интеграции (API или DMP)
4

Получение URL

После создания вы получите уникальный webhook URL

​
Ограничения

Важные ограничения:
  • Максимальное количество интеграций для одной организации: 5
  • Webhook URL является конфиденциальной информацией, не передавайте его третьим лицам

​
API интеграция (Webhook)

​
Webhook URL

После создания интеграции вы получите URL в формате: 
https://{домен}/api/upload-contacts-integrations/webhook/{webhookToken}

​
Формат данных

Отправляйте данные в формате JSON, поддерживаются как одиночные объекты, так и массивы: 
[
  {
    "phone": "79001234567",
    "tags": ["тег1", "тег2"],
    "additionalFields": {
      "client_name": "Иван",
      "age": 30,
      "other_info": "значение"
    }
  }
]

​
Обязательные поля

​
Пример запроса

curl -X POST \
  https://example.com/api/upload-contacts-integrations/webhook/ваш-токен \
  -H 'Content-Type: application/json' \
  -d '[
    {
      "phone": "79001234567",
      "tags": ["лид", "сайт"],
      "additionalFields": {
        "источник": "реклама",
        "utm_source": "google"
      }
    }
  ]'

​
DMP интеграция

​
Формат данных

Для DMP интеграции обрабатывается специальный формат данных: 
[
  {
    "phone": "79001234567",
    "website": "example.com",
    "другие_поля": "значения"
  }
]

​
Обязательные поля

​
Обработка ошибок

Возможные HTTP коды ответов:
Успешная обработка запроса
Некорректные данные (например, отсутствует обязательное поле)
Интеграция не найдена (неверный токен)
Интеграция неактивна

​
Дополнительная информация

Все контакты, загруженные через интеграцию, привязываются к соответствующему колл-листу

​
Технические ограничения

Важные моменты:
  • Уникальные контакты определяются по номеру телефона
  • Дубликаты не добавляются
  • При отправке большого количества контактов рекомендуется разбивать запросы на части до 1000 записей