API для интеграций
API позволяет автоматически загружать базы контактов в NomerGO из вашей CRM или сайта — например, новые заявки сразу попадают в базу для обзвона. Раздел «API» доступен администратору.
Токен доступа
- Откройте «API», укажите название токена (например, «интеграция с CRM») и нажмите «Создать токен».
- Скопируйте токен сразу — он показывается только один раз.
- Передайте токен разработчику интеграции.
В списке токенов видно, когда каждый последний раз использовался. Кнопка «Отозвать» отключает токен — интеграции с ним перестанут работать.
Что умеет API
| Запрос | Что делает |
|---|---|
GET /lists | Список баз: номер базы, название, число контактов |
POST /lists | Создать базу (название, описание) |
POST /lists/{номер базы}/contacts | Добавить контакты: списком в JSON, CSV-текстом или файлом CSV |
Адрес API: https://lk.nomergo.ru/api/v1. Каждый запрос передаёт токен в заголовке Authorization: Bearer <токен>; ответы приходят в формате JSON. Ограничение — 120 запросов в минуту.
При добавлении контактов номера обрабатываются так же, как при загрузке файла: приводятся к единому виду, дубликаты пропускаются, лишние поля сохраняются как дополнительные данные контакта. В ответ приходит, сколько контактов принято, добавлено, сколько дубликатов и некорректных номеров.