Webhook — метод создания связи между двумя инструментами.

Чтобы настроить webhook:

  1. Нажмите на аватар профиля в правом верхнем углу.
  2. В раскрывшемся меню выберите «Управление интеграциями».
  3. В открывшемся окне выберите «API/Webhook».
  4. Выберите чат, для которого вы хотите подключить Webhook.
  5. Нажмите «Сохранить».
  6. Вам будет сгенерирован уникальный API-ключ.

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/23a38bcd-c4f0-4a2f-b492-8d9db5a164f6/webhook.gif

Для отправки сообщений (POST)

Надо сделать POST-запрос на адрес https://web.tada.team/api/message с параметрами:

[key API-ключ] для этой команды и этой группы: YFamt2E_z_5YvIvKdNtQc9GDju0

[message] само сообщение

Пример для командной строки:

curl <https://web.tada.team/api/message> \\
	-F key='YFamt2E_z_5YvIvKdNtQc9GDju0' \\
	-F message='Ваше сообщение'

Для получения сообщений в чат (GET)

Если задан Webhook URL, на него при каждом новом сообщении будет отправляться POST-запрос с параметрами: ["chat","chat_display_name"], ["created"], ["sender"], ["sender_display_name"] и, самое главное: ["text"].

Кроме этого, в запросе будет http-заголовок ["key"], равный API-ключу этой группы (YFamt2E_z_5YvIvKdNtQc9GDju0), чтобы вы могли убедиться, что запрос именно от нас. Если сервер отвечает кодом, отличным от 200, запрос повторится ещё 8 раз с нарастающим интервалом.

Документация по нашему открытому API — https://tada-team.github.io/tdproto-docs-ru/

Больше технических деталей вы можете найти на нашем GitHub

tada.team