Работа с чатами

1. Получаем API ключ

Для этого переходим в личном кабинете в раздел Интеграции. Создаём интеграцию с типом API, указываем, к каким разделам интеграция имеет доступ (нужны как минимум "Сообщения" и "Вебхуки") и сохраняем ключ.

2. Проверяем, какие источники чатов есть в компании

Это можно сделать, отправив запрос https://api.radist.online/v2/docs#/Messaging/MessagingGetChatsSources

На данный момент доступно 4 типа источников: whatsapp, waba, telegram, telegram_bot.

Пример ответа:

[
  {
    "connection_id": 123,
    "name": "Номер 1",
    "type": "whatsapp",
    "create_chat": {
      "with_phone": true,
      "with_username": false
    },
    "subscription": {
      "id": 1,
      "paid_until": "2025-03-17T13:35:35.728Z",
      "subscription_plan": "STANDARD"
    }
  },
  {
    "connection_id": 456,
    "name": "Продажи",
    "type": "waba",
    "create_chat": {
      "with_phone": true,
      "with_username": false
    }
    "subscription": {
      "id": 2,
      "paid_until": "2025-03-17T13:35:35.728Z",
      "subscription_plan": "STANDARD"
    }
  },
  {
    "connection_id": 789,
    "name": "test telegram",
    "type": "telegram",
    "create_chat": {
      "with_phone": true,
      "with_username": true
    },
    "subscription": {
      "id": 3,
      "paid_until": "2025-03-17T13:35:35.728Z",
      "subscription_plan": "ADVANCED"
    }
  },
  {
    "connection_id": 1001,
    "name": "tg bot",
    "type": "telegram_bot",
    "create_chat": {
      "with_phone": false,
      "with_username": false
    },
    "subscription": {
      "id": 11,
      "paid_until": "3000-03-17T13:35:35.728Z",
      "subscription_plan": "FREE"
    }
  }
]

В ответе указывается id подключения, его название, тип, а также флаги, показывающие, как эти источники могут создавать чаты. Например, подключения waba, whatsapp могут создавать чаты только с использованием номера телефона. Подключения telegram с использованием телефона или имени пользователя. telegram_bot не могут создавать чаты.

3. Подписываемся на вебхуки

Для того, чтобы получать уведомления, когда приходят новые сообщения или отправленные сообщения доставлены/прочитаны, необходимо подписаться на вебхуки. Как это сделать описано здесь.

4. Создаём чат

Если вы хотите написать клиенту, переписки с которым ещё не было, необходимо сначала создать с ним чат. Как это сделать описано здесь.

5. Отправляем сообщения

Как это сделать описано здесь.