Практические инструкции
Подключение результатов звонков
Согласование передачи результатов в CRM или другую систему
Подключение результатов звонков
Статус: assisted onboarding. Публичный стабильный webhook contract пока не опубликован.
Что нужно согласовать
До подключения заказчик и назначенный оператор AGONTS фиксируют:
- Получателя результата: CRM, ERP или внутренний API.
- События и поля, которые нужны принимающей системе.
- Способ аутентификации и ротации секрета.
- Политику повторов, дедупликации и обработки ошибок.
- Срок хранения delivery logs и контакт для инцидентов.
Требования к контракту
| Область | Правило |
|---|---|
| Transport | Production endpoint использует TLS |
| Schema | Payload получает версию и машиночитаемую JSON Schema |
| Idempotency | Событие имеет стабильный уникальный идентификатор; принимающая система дедуплицирует его |
| Authentication | Способ подписания или токен согласуется до передачи секрета |
| Retry | Коды, backoff и предел попыток фиксируются в integration contract, а не предполагаются клиентом |
| Privacy | Payload содержит только согласованные поля; логи не публикуют секреты и полный контактный реестр |
Процедура подключения
- Передайте назначенному оператору описание endpoint и требуемых полей по согласованному безопасному каналу.
- Получите версию payload contract, authentication scheme и список возможных статусов.
- Реализуйте idempotent handler и сохранение исходного event ID.
- Проведите синтетическую отправку без данных реального абонента.
- Зафиксируйте ожидаемую реакцию на success, retryable failure и permanent failure.
- Разрешите production delivery только после совместной приёмки.
Если контракт ещё не предоставлен
Не угадывайте URL, заголовок подписи, timeout, количество повторов или поля payload. Запросите их у назначенного оператора AGONTS. До фиксации контракта передача результатов остаётся ручной или использует отдельно согласованный канал.