С помощью метода можно подключить отправку вебхуков на переданный URL. В параметрах можно указать, какие сообщения передавать в хуке:

• [offersMessagesIncoming] — все входящие сообщения по объявлениям;
• [offersMessagesIncoming, offersMessagesLkOutgoing] — все входящие и исходящие по объявлениям, отправленные не через API;
• [offersMessagesIncoming, offersMessagesLkOutgoing, offersMessagesApiOutgoing] — все входящие и все исходящие сообщения по объявлениям.
• [newbuildingMessagesIncoming] - все входящие сообщения по новостройкам;
• [newbuildingMessagesIncoming, newbuildingMessagesLkOutgoing] — все входящие и исходящие по новостройкам, отправленные не через API;
• [newbuildingMessagesIncoming, newbuildingMessagesLkOutgoing, newbuildingMessagesApiOutgoing] — все входящие и все исходящие сообщения по новостройкам.
• [systemMessages] — системные сообщения от Циан и модерации;
• [chatsReadability] — вебхук о прочитанности чата;

Например:

• [offersMessagesIncoming] — только входящие сообщения по объявлениям;
• [offersMessagesIncoming, systemMessages] — только входящие по объявлениям и системные сообщения;
• [offersMessagesIncoming, offersMessagesLkOutgoing, systemMessages] — все входящие и исходящие по объявлениям, отправленные не через API, а также системные сообщения от Циан и модерации.

<b>Важно!</b>

• В вебхуке будут приходить все новые сообщения по всем чатам — это может быть одно или несколько сообщений.
• Если в течение больше 72 часов не удается доставить сообщения на URL, он будет автоматически отключен.
• В ответе метода указаны модели вебхуков, которые будут отправляться на указанные URL.

Пример:

curl -X POST -H 'Authorization: Bearer <ACCESS TOKEN>' https://public-api.cian.ru/v2/subscribe-webhooks --header 'Content-Type: application/json' --data-raw '{"url": "https://example.com", "webhookTypes": ["offersMessagesIncoming"]}'