Краткие сведения
Описание
Метод позволяет отправить файл в чат.
Запрос к серверу
Поле | Тип | Описание |
|---|---|---|
line_id | UUID | ID линии поддержки |
user_id | UUID | ID пользователя |
author_id | UUID | ID автора (специалиста, от имени которого отправляется файл) |
file_name | String | Имя файла |
comment | String? | Комментарий к файлу |
bot_as_spec | Boolean? | Данное сообщение будет отправлено от имени специалиста и обращение пойдет по стандартным правилам! Специалист, от лица которого отправляется сообщение (поле author_id), должен быть в онлайне и в статусе отличном от "Нет на месте" и "Не беспокоить", во избежании лишних переназначений или постановок пользователя в очередь ожидания специалиста. |
notification_only | Boolean? | Только сообщение в чат. Специалист, от лица которого отправляется сообщение (поле author_id), не становится назначенным. При отсутствии открытого обращения, новое не будет открыто. |
Пример
Отправка сообщения с клавиатурой
POST /v1/line/send/file/ HTTP/1.1
Host: push.1c-connect.com
Accept: application/json
Authorization: Basic dGVzdDp0ZXN0
Content-Length: 1880
Expect: 100-continue
Content-Type: multipart/form-data; boundary=------------------------a8e0b5125d5a8247
--------------------------a8e0b5125d5a8247
Content-Disposition: form-data; name="meta"
Content-Type: application/json
{ "line_id": "b34a9aca-ff75-11e7-80e6-0025904f970f", "user_id": "26c44945-56f4-11e1-bd8d-92568227dc5f", "file_name": "как употреблять женьшень.txt", "keyboard": [ [ { "id": "a", "text": "Первая" }, { "id": "b", "text": "Вторая" } ], [ { "id": "c", "text": "Третья" }, { "id": "d", "text": "Четвертая" } ], [ { "id": "e", "text": "Пятая" } ] ]}
--------------------------a8e0b5125d5a8247
Content-Disposition: form-data; name="file"; filename="как употреблять женьшень.txt"
Content-Type: text/plain
Буквально на следующий год после войны в советских аптеках стал появляться до тех пор неизвестный, новый препарат — настойка женьшеня. Когда в их аптеку пришла упаковка этого нового препарата, то никто не знал, как его использовать. И их заведующий аптекой, обстоятельный пожилой фармацевт, отправился на почту и отбил телеграмму в республиканское Аптекоуправление: «Разъясните, как употреблять женьшень».
Телеграфисткам также раньше не встречалось это слово, поэтому телеграмма получилась такая: «Разъясните, как употреблять женщин».
Ответ из Аптекоуправления был такой: «Способ употребления остаётся прежним».
--------------------------a8e0b5125d5a8247--
Curl
curl -X POST "https://push.1c-connect.com/v1/line/send/file/" \
-H "accept: application/json" \
-H "Content-Type: multipart/form-data" \
-u test:test \
-F "meta={ \"line_id\": \"b34a9aca-ff75-11e7-80e6-0025904f970f\", \"user_id\": \"26c44945-56f4-11e1-bd8d-92568227dc5f\", \"file_name\": \"как употреблять женьшень.txt\", \"keyboard\": [ [ { \"id\": \"a\", \"text\": \"Первая\" }, { \"id\": \"b\", \"text\": \"Вторая\" } ], [ { \"id\": \"c\", \"text\": \"Третья\" }, { \"id\": \"d\", \"text\": \"Четвертая\" } ], [ { \"id\": \"e\", \"text\": \"Пятая\" } ] ]};type=application/json" \
-F "file=@/tmp/как употреблять женьшень.txt"
Ответ сервера
Нет тела
Ошибки
Код | Описание |
|---|---|
400 | Запрос содержит ошибку |
401 | Пользователь не авторизован |
403 | Недостаточно прав |