API и Webhooks: как устроены интеграции Enterprise

На тарифе Enterprise TenancyDesk связывается с собственными системами агентства двумя способами:

• Webhooks сообщают вашей системе, когда что-то меняется в сделках, платежах, документах, контактах, задачах или соответствии. Их настраивает ваш Admin в Settings → Webhooks; отдельного одобрения не нужно.
• Внешний API позволяет вашей системе читать записи агентства. Он только для чтения и выдаётся на каждую интеграцию после того, как наша команда проверит, что ей нужно; с тарифом он не включается.

Webhooks

1. В Settings → Webhooks добавьте адрес своей системы и выберите события, которые она будет получать.
2. Сохраните секрет подписи, когда он показан: по нему ваша система проверяет, что доставка действительно пришла от TenancyDesk.
3. Recent Deliveries показывает, что было отправлено и что ответила ваша система. Неудавшаяся доставка повторяется.

Внешний API

1. В Settings → API Keys опишите, что должна делать интеграция, и нажмите Send request.
2. Наша команда проверяет объём и отвечает на указанный вами адрес.
3. Когда доступ выдан, ваш Admin создаёт там ключ. Ключ показывается один раз, при создании, — сохраните его надёжно.

Ключ видит только записи вашей компании. Его можно ограничить определёнными эндпоинтами и IP-адресами и задать срок действия.

Порталы объявлений — отдельно

Property Finder работает через собственные API-учётные данные агентства, а Bayut / dubizzle — через импорт Excel из Profolio. Ни тому, ни другому API Enterprise не нужен.

Следующий шаг

Прочитайте страницу Developer API and Webhooks, затем свяжитесь с нами и опишите нужный процесс.