Важно: через API сейчас у нас можно отвечать на комментарии/сообщения или удалять комментарии. Это можно делать только в тех соцсетях, где это возможно. Мы поддерживаем много соцсетей-мессенджеров и это все возможно не везде.
Все остальные операции - подключения сообществ, выгрузки в эксель итд - делаются только в личном кабинете.
Токен — подтверждает ваше право подключаться к системе. Без токена Chotam не позволит вам ничего делать.
Вы получите токен, когда зарегистрируетесь в сервисе Chotam и начнете настраивать интеграцию.
Набор правил (в старой терминологии - Проект) — это наша внутренняя сущность, которая группирует подключения. Например, в проекте могут быть:
Группа ВКонтакте
Бизнес-аккаунт в Instagram
Telegram-канал
Вы можете это или разделить на несколько наборов правил (например, лид из Инсты слать сюда, а коммент из ВК слать сюда) или оставить как один ("Основной") - который есть у всех.
Все операции по связке подключений и наборов правил делаются внутри кабинета. API работает только на уровне - "мы получили сообщение/коммент - вы можете ответить или удалить"
По сути, вы получаете ID набора правил от нас и в ответной команде отправляете его нам
Интеграция — это подключение Chotam к вашему сервису. По факту, это набор из трех компонент:
- токен, который мы вам даем - он подтверждает права
- адрес сервера нашего - куда вы отправляете команды (он по
- адрес серверва вашего (webhook) - куда мы шлем информацию о том, что получен новый комментарий/сообщение
Webhook — это адрес, на который Chotam будет присылать уведомления. Например, если кто-то оставил комментарий — webhook получит это событие.