(Не используется) SendLink#
Метод устарел и более не используется. Для замены смотрите метод SendMessage.
Метод предназначен для отправки сообщения со ссылкой, по которой будут добавлены превью изображения, заголовок и описание. Сообщение на отправку хранится 24 часа в очереди и будет отправлено сразу же после авторизации телефона. Картинка, заголовок и описание получаются из Open Graph разметки страницы, на которую указывает ссылка. Сообщение будет добавлено в очередь на отправку. Скорость отправки сообщений из очереди регулирует параметр Интервал отправки сообщений.
Запрос#
Для отправки сообщения со ссылкой требуется выполнить запрос по адресу:
{{apiUrl}}/waInstance{{idInstance}}/sendLink/{{apiTokenInstance}}
Для получения параметров запроса apiUrl
, idInstance
и apiTokenInstance
обратитесь к разделу Перед началом работы.
Параметры запроса#
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
chatId | string | Да | Идентификатор чата |
urlLink | string | Да | Адрес ссылки |
quotedMessageId | string | Нет | Идентификатор цитируемого сообщения,если указан то сообщение отправится с цитированием указанного сообщения чата |
Рекомендуется, чтобы страница, на которую указывает ссылка
urlLink
содержала разметку Open Graph. В этом случае сообщение будет дополнено картинкой, заголовком и кратким описанием.
Пример тела запроса#
Отправка сообщения в личный чат:
{
"chatId": "11001234567@c.us",
"urlLink": "https://green-api.com"
}
Отправка сообщения в групповой чат:
{
"chatId": "120363043968066561@g.us",
"urlLink": "https://green-api.com"
}
Отправка сообщения в личный чат:
{
"chatId": "11001234567@c.us",
"urlLink": "https://green-api.com",
"quotedMessageId": "361B0E63F2FDF95903B6A9C9A102F34B"
}
Ответ#
Поля ответа#
Поле | Тип | Описание |
---|---|---|
idMessage | string | Идентификатор отправленного сообщения |
Пример тела ответа#
{
"idMessage": "3EB0C767D097B7C7C030"
}
Ошибки SendLink#
Перечень общих для всех методов ошибок смотрите в разделе Стандартные ошибки
Пример кода на Python#
import requests
url = "{{apiUrl}}/waInstance{{idInstance}}/sendLink/{{apiTokenInstance}}"
payload = "{\r\n\t\"chatId\": \"11001234567@c.us\",\r\n\t\"urlLink\": \"https://green-api.com\"\r\n}\r\n"
headers = {
'Content-Type': 'application/json'
}
response = requests.post(url, json=payload)
print(response.text.encode('utf8'))