Перейти к содержанию

(Не используется) SendLink#

Метод устарел и более не используется. Для замены смотрите метод SendMessage.

Метод предназначен для отправки сообщения со ссылкой, по которой будут добавлены превью изображения, заголовок и описание. Сообщение на отправку хранится 24 часа в очереди и будет отправлено сразу же после авторизации телефона. Картинка, заголовок и описание получаются из Open Graph разметки страницы, на которую указывает ссылка. Сообщение будет добавлено в очередь на отправку. Скорость отправки сообщений из очереди регулирует параметр Интервал отправки сообщений.

Запрос#

Для отправки сообщения со ссылкой требуется выполнить запрос по адресу:

POST 
{{apiUrl}}/waInstance{{idInstance}}/sendLink/{{apiTokenInstance}}

Для получения параметров запроса apiUrl, idInstance и apiTokenInstance обратитесь к разделу Перед началом работы.

Параметры запроса#

Параметр Тип Обязательный Описание
chatId string Да Идентификатор чата
urlLink string Да Адрес ссылки
quotedMessageId string Нет Идентификатор цитируемого сообщения,если указан то сообщение отправится с цитированием указанного сообщения чата

Рекомендуется, чтобы страница, на которую указывает ссылка urlLink содержала разметку Open Graph. В этом случае сообщение будет дополнено картинкой, заголовком и кратким описанием.

Пример тела запроса#

Отправка сообщения в личный чат: 

{
    "chatId": "79876543210@c.us",
    "urlLink": "https://green-api.com"
}

Отправка сообщения в групповой чат: 

{
    "chatId": "120363043968066561@g.us",
    "urlLink": "https://green-api.com"
}

Отправка сообщения в личный чат: 

{
    "chatId": "79876543210@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\": \"79876543210@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'))