API-ключи

Дайте своей программе работать с Говорило API — список звонков, создание агентов, покупка номеров, чтение вашей CRM — по ключу в одном заголовке.

Все тарифы, включая пробныйДля разработчиков

API-ключ позволяет вашей собственной программе работать с Говорило API: получать список звонков, создавать агентов, покупать номера, читать вашу CRM. Ключ действует с вашими правами — что вы можете сделать в кабинете, то он может сделать через API.

Что может ваша программа

Читать ваши звонки — транскрипты, резюме и извлечённые поля, для своих отчётов или систем.
Управлять агентами и номерами — создавать агентов, покупать номера.
Читать вашу CRM — данные о ваших контактах, которые хранит Говорило.
Проверять доставку вебхуков — смотреть журнал доставки и отправлять доставку повторно.

Создание ключа

Откройте ключи
Интеграции → вкладка Разработчикам → API-ключи воркспейса.
Создайте ключ
Нажмите Создать API-токен. Ключ появится в списке; кнопка показа откроет его, оттуда его и скопируйте.

До 3 ключей на рабочее пространство.
У ключей нет названия и отдельных прав: ключ получает ваш доступ во всех рабочих пространствах, где вы состоите.
Ключ можно снова показать из списка — поэтому относитесь к списку как к секретным данным.

Как использовать

Передавайте ключ в заголовке x-api-key, без префикса Bearer:

curl "https://api.govorilo.tech/v1/agent/list" \
  -H "x-api-key: YOUR_API_KEY"

Все эндпоинты описаны в Справочнике API.

Примеры сценариев

Список агентов из скрипта Ваш сервер отправляет GET /v1/agent/list с ключом в x-api-key → получает ваших агентов, тех же, что вы видите в кабинете.

Догнать доставки, которые пропустила ваша система Ваш сервер запрашивает GET /v1/webhook-deliveries с доставками в статусе failed → отправляет каждую заново через POST /v1/webhook-deliveries/{id}/resend.

Безопасность

Храните ключи на своём сервере — никогда в браузере, в мобильном приложении или в чём-либо, что может открыть пользователь.
Никогда не добавляйте их в систему контроля версий.
Время от времени меняйте их; сразу удаляйте ключ, если кто-то ушёл из команды или ключ мог утечь.

Ограничения

До 3 ключей на рабочее пространство.
Без отдельных прав: ключ получает ваш доступ во всех рабочих пространствах, где вы состоите.

Частые проблемы

Проблема	Что проверить
Запросы отклоняются	Ключ передаётся в заголовке `x-api-key`, без префикса `Bearer`
Не получается создать ещё один ключ	В рабочем пространстве до 3 ключей — удалите тот, которым больше не пользуетесь
Ключ мог утечь	Сразу удалите его и создайте новый