API и вебхуки

Версия Pro добавляет два способа интеграции PrimoCRM с остальным стеком: ключи API для программного доступа и исходящие вебхуки для отправки событий в другие системы.

Ключи API

Ключи API позволяют внешним приложениям и скриптам программно читать и записывать данные в PrimoCRM.

Перейдите в Настройки, затем в API и создайте ключ.
Храните ключ в безопасности. Обращайтесь с ним как с паролем.
Используйте его для аутентификации запросов из вашего приложения.

Типичные сценарии использования:

Синхронизация контактов из системы, не имеющей прямой интеграции.
Добавление или обновление контактов из кастомной формы регистрации.
Выгрузка данных на внутренний дашборд.

Исходящие вебхуки

Действие автоматизации Исходящий вебхук отправляет HTTP POST-запрос на выбранный вами URL, когда процесс доходит до этого шага. Используйте его для уведомления других сервисов в режиме реального времени.

Добавьте шаг Исходящий вебхук в автоматизацию.
Укажите целевой URL.
Настройте полезную нагрузку (payload). Вы можете включать данные контакта с помощью смарт-кодов.

Практический пример

Триггер: создан заказ в WooCommerce.
Исходящий вебхук: POST-запрос к вашей службе выполнения заказов с email контакта и деталями заказа.
Добавить тег: customer.

Как только заказ оформлен, ваша внешняя система получает уведомление, а контакту присваивается тег без каких-либо ручных действий.

Замечания по безопасности

Направляйте вебхуки только на те эндпоинты, которые вы контролируете или которым доверяете. Вебхук может передавать данные контакта на целевой URL.
Отдавайте предпочтение HTTPS-адресам, чтобы полезная нагрузка шифровалась при передаче.
Проверяйте входящие запросы вебхуков на принимающей стороне.

Информация о том, где они располагаются в каталоге, приведена в разделе Триггеры и действия.