С FOQUZ можно интегрироваться двумя способами:
- по API, то есть ваш сервер обращается к нашему через методы API, FOQUZ выполняет действие, заданное запросом, и в ответ вы получаете какие-либо данные (ответы, контакты, сообщение о статусах отправки и так далее);
- по Webhook: вы даёте нам URL сервиса (обработчика получаемых от нас данных) и мы настраиваем отправку вам информации о каждом новом полученном ответе.
С помощью обращений по API можно
- Получать список ответов: за период, по выбранным опросам и по конкретным респондентам. Сейчас есть две версии этого метода, рекомендуем использовать метод «Получение ответов (v2)»;
- Получать список опросов вашего аккаунта;
- Отправлять опросы контактам: через этот метод можно как отправлять уникальные ссылки контактам, так и просто получать их в ответе сервера.
- Создавать и редактировать базу контактов, чтобы проводить по ней исследования и анализировать её в FOQUZ.
API токен для интеграции: в каждом запросе нужно указывать ваш уникальный ключ аккаунта, чтобы получить доступ к данным. Его можно получить в разделе «Настройки → Общие настройки → Интеграция».
Наш Webhook
Webhook нужен для того, чтобы получать информацию о новом ответе на опрос в стороннем сервисе. Вебхук — это POST запрос на указанный URL, в теле которого находится JSON-объект с информацией о новом ответе на опрос.
Для настройки Webhook необходимо обратиться в нашу команду технической поддержки. Формат получаемых данных от вебхука можно посмотреть тут.
