API и вебхуки SupportHub

Основная работа оператора доступна через API: создавать тикеты, отвечать клиентам, работать с контактами и файлами. События приходят вебхуками или через long polling, так что SupportHub встраивается в CRM, биллинг или ваш собственный канал.

Интеграция с CRM
CRM

POST /tickets — «Ошибка 500 при оплате тарифа»

Оператор

Нашли причину, повторите оплату, пожалуйста.

Вебхук

message.created → https://crm.example.com/hooks/supporthub

REST API

Тикеты, сообщения, контакты, история обращений, оценки и файлы. Доступ — по токенам с правами, которые можно отозвать и перевыпустить.

События: вебхуки или long polling

Вебхуки приходят на ваш адрес сразу после события, с подписью, которую легко проверить, и повторами при ошибках. Если публичного адреса нет, события забираются запросом /updates — как getUpdates у Telegram-ботов.

Python SDK

Официальный клиент с типизированными моделями, повторами запросов, синхронным и асинхронным режимом и встроенным long polling. Для остальных языков есть примеры на cURL и Node.

Свой канал

Через API можно подключить любой источник обращений — мобильное приложение, свой мессенджер или бота — и работать с ним в той же очереди, что и с Telegram или почтой.

Как подключить

  1. 1

    Создайте API-ключ

    В настройках проекта; ключ показывается один раз. Подробнее

  2. 2

    Подпишитесь на события

    Вебхуком или через long polling. Подробнее

  3. 3

    Начните с примеров

    Готовые сценарии на cURL, Python и Node. Подробнее

Частые вопросы

Есть ли ограничения на запросы?

Да, лимиты и коды ошибок описаны в документации вместе с рекомендуемой стратегией повторов.

Как проверить, что вебхук пришёл от SupportHub?

Каждый запрос подписан секретом, который выдаётся при создании подписки.

Смотрите также

  • BILLmanager

    Тикеты BILLmanager 6 от ISPsystem: ответы, вложения, оценки и закрытие синхронизируются.

  • Почта

    Письма клиентов как тикеты, ответы с вашего адреса по IMAP и SMTP.

  • Telegram

    Бот поддержки с меню и кнопками, ответы операторов из общей очереди.

Подключите свои каналы и посмотрите на живых обращениях

Тариф Starter бесплатный, платный можно попробовать 14 дней. Настройка занимает несколько минут.