API в калькуляторе
tg_callback(platform_id, callback_message)
callback(client_id, callback_message)
message(client_id, text, message_id) отправка текста или блок из схемы. Парамтер message_id необязательный
whatsapp_message(phone, text, message_id) отправка сообщения в whatsapp
Работает только на тарифе "Премиум"
Как прикреплять голосовые сообщения, фото, видео, анимацию и стикеры не ссылками, а внутренними файлами Телеграм, читайте тут
tg_answer_callback_query(callback_query_id, text, show_alert=True, cache_time=60)
Временно кешируется id коллбэка от инлайн-кнопки. Тем самым отключается повторное нажатие кнопки и приходит текст, указанный в переменной text
tg_send_document(platform_id, document, caption, reply_markup, parse_mode)
где platform_id — id клиента в мессенджере, document — ссылка на отправляемый документ, caption — описание (необязательный параметр), reply_markup — настройки кнопок (необязательный параметр), parse_mode — выделение текста в описании жирным или курсивом (необязательный параметр)
tg_send_voice(platform_id, voice, caption, reply_markup, parse_mode)
где platform_id — id клиента в мессенджере, voice — ссылка на голосовое сообщение в формате .OGG, caption — описание до 1024 символов (необязательный параметр), reply_markup — настройки кнопок (необязательный параметр), parse_mode — выделение текста в описании жирным или курсивом (необязательный параметр)
tg_send_animation(platform_id, animation, caption, reply_markup, parse_mode)
где platform_id — id клиента в мессенджере, animation — ссылка на анимацию, caption — описание до 1024 символов (необязательный параметр), reply_markup — настройки кнопок (необязательный параметр), parse_mode — выделение текста в описании жирным или курсивом (необязательный параметр)
tg_send_video(platform_id, video, caption, reply_markup, parse_mode)
где platform_id — id клиента в мессенджере, video — ссылка на видео, caption — описание до 1024 символов (необязательный параметр), reply_markup — настройки кнопок (необязательный параметр), parse_mode — выделение текста в описании жирным или курсивом (необязательный параметр)
tg_send_venue(platform_id, latitude, longitude, title, address)
где вводятся данные: platform_id — id клиента в мессенджере, latitude —широта, longitude — долгота, title — название, address — адрес.
tg_send_contact(platform_id, phone, first_name, last_name)
где phone — номер телефона в международном формате. Например, для РФ это +7XXXXXXXXXX, first_name и last_name вводятся вручную.
tg_send_sticker(platform_id, sticker_id)
где platform_id — id клиента в мессенджере, sticker_id — id стикера. Его можно получить, отправив нужный стикер боту https://t.me/RawDataBot . В ответ бот присылает данные, нам нужен последний параметр file_id.
tg_send_video_note(platform_id, video_note)
где platform_id — id клиента в мессенджере, video_note — id видео. Его можно получить, отправив нужное видео боту https://t.me/RawDataBot. В ответ бот присылает данные, нам нужен последний параметр file_id.
tg_send_photo(platform_id, photo, caption, reply_markup, parse_mode)
photo — ссылка на картинку или file_id, полученный у бота RawDataBot, caption — описание до 1024 символов (необязательный параметр), reply_markup — настройки кнопок (необязательный параметр), parse_mode — выделение текста в описании жирным или курсивом (необязательный параметр)
tg_send_message(platform_id, text, client_message_id, reply_markup, parse_mode)
client_message_id - идентификатор сообщения, которое необходимо процитировать (необязательный параметр)
reply_markup — настройки кнопок (необязательный параметр)
parse_mode — выделение текста в описании жирным или курсивом (необязательный параметр)
Пример отправки курсивного текста: tg_send_message(47615196, "<i>курсив</i>",None,None,"html")
Пример отправки жирного текста: tg_send_message(platform_id, '*test*', None, None, 'markdown')
tg_forward_message(platform_id, from_chat_id, message_id) переслать сообщение
platform_id — куда пересылать сообщение, from_chat_id — значение #{platform_id}, откуда пересылать сообщение, message_id —id пересылаемого сообщения
tg_create_chat_invite_link(platform_id, member_limit=None, hours=None)
hours - количество часов, которое будет действовать ссылка
tg_ban_chat_member(platform_id, user_id, hours=99999, revoke_messages=True)
revoke_messages — необязательный параметр, означает, удалять все сообщения пользователя или нет
tg_unban_chat_member(platform_id, user_id, only_if_banned=True)
Редактирование текста в сообщении:
tg_edit_message_text(platform_id, message_id, text, parse_mode, reply_markup)
Параметры parse_mode, reply_markup (редактировать можно только инлайн клавиатуру), disable_web_page_preview — необязательные
Редактирование описания: tg_edit_message_caption(platform_id, message_id, caption, reply_markup)
Параметр reply_markup необязательный. Редактировать можно только инлайн клавиатуру
Редактирование сообщения с медиа: tg_editMessageMedia(platform_id, message_id, media, reply_markup)
Параметр reply_markup необязательный (редактировать можно только инлайн клавиатуру)
tg_delete_message(platform_id, message_id)
parse_mode выделяет весь текст/его часть курсивом или жирным шрифтом. Может иметь значения html или markdown.
Если выбираете html:
для жирного шрифта используете "<b>caption</b>"
для курсива "<i>caption</i>"
Для Markdown:
для жирного шрифта используете "*caption*"
для курсива "_caption_"
Пример:
В методах send_document, send_voice, send_animation, send_video, send_photo можно не вставлять ссылки на внешние ресурсы, а пользоваться файлами в Telegram.
Например, нам нужно отправить голосовое сообщение. Для этого мы воспользуемся ботом https://t.me/mp3toolsbot. Отправляем ему нужный файл, который нужно сконвертировать в OGG формат. Далее нажимаем Voice Converter, а потом Save.
На выходе получаем:
Далее мы пересылаем это сообщение своему боту, а оттуда пересылаем в https://t.me/RawDataBot. Нам приходит ответ, где нужно скопировать последнее значение file_id
Его мы вставляем сюда:
И получаем
Если вы будете пересылать файл напрямую из бота mp3 Tools в Telegram bot Raw, то будет ошибка:
Поэтому сначала необходимо отправить в своего бота, а из него —Telegram bot Raw,
Если нужно отправить видео, фото, документ, то отправляете нужный файл своему боту и оттуда пересылаете в Telegram bot Raw. Далее копируете file_id и т.д., как описано выше.
Работает только на тарифе "Премиум"
vk_send_message(platform_id, message, keyboard, reply_to, forward_messages, sticker_id, dont_parse_links)
где platform_id — id клиента в мессенджере, message — текст сообщения, keyboard — кнопки в сообщении (необязательный параметр), reply_to — id сообщения для ответа/цитаты (необязательный параметр), forward_messages — id пересылаемых сообщений (перечисляются в виде "{#айдипервогосообщения}, #{второго}, #{итакдалее}", sticker_id — id стикера (необязательный параметр), dont_parse_links — создавать сниппет или нет, может принимать значение 1 — создавать, 0 — нет (необязательный параметр)
vk_delete_last_message()
в скобках ничего не указывается. Произойдёт удаление последнего сообщения в беседе. На личные сообщения не распространяется
vk_send_sticker(platform_id, sticker_id)
где platform_id — id клиента в мессенджере, sticker_id — id стикера.
Как узнать id стикера? Тот, кто подключал бота ВК, отправляет в бота нужный стикер. Его id при этом записывается в переменную. Значение переменной копируете из раздела Клиенты (см скрин:)
Результат
vk_get_name(platform_id, full)
где full может принимать значение True (вы получите имя и фамилию) и False (получите только имя)
Если вы собираетесь использовать vk_get_name в беседе сообщества, вместо platform_id нужно указать from_id
Чтобы иметь возможность отвечать под комментариями, нужно вручную добавить токен.
Для этого заходите в вашу группу ВК, открываете Управление / Работа с API.
Чтобы иметь возможность отвечать под комментариями, нужно вручную добавить токен.
Для этого заходите в вашу группу ВК, открываете Управление / Работа с API.
Нажимаете "Создать ключ" и копируете его.
Дальше переходите в Salebot, раздел Мессенджеры и чаты, в подключении ВК выбираете "Показать токены". Сюда вставляете скопированный токен и жмете "Добавить".
vk_create_comment(post_id, message, reply_to_comment, sticker_id)
где post_id — id комментируемого поста, message — текст комментария, reply_to_comment — id комментария, на который отвечаем (необязательный параметр), sticker_id — id стикера (необязательный параметр)
amo_change_state(status_id, lead_id=None)
где status_id — id этапа воронки, на который надо перенести бота, lead_id — id сделки, котору необходимо передвинуть(необязательный параметр, по умолчанию берется из переменной amo_lead_id).
Ид состояния необходимо взять из исходников страницы AmoCRM:
