API в калькуляторе

Упрощенные вызовы API из калькулятора

API Salebot

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

API Telegram

Работает только на тарифе "Премиум"

Как прикреплять голосовые сообщения, фото, видео, анимацию и стикеры не ссылками, а внутренними файлами Телеграм, читайте тут

Отключение повторного нажатия инлайн кнопки:

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

parse_mode выделяет весь текст/его часть курсивом или жирным шрифтом. Может иметь значения html или markdown.

Если выбираете html:

для жирного шрифта используете "<b>caption</b>"

для курсива "<i>caption</i>"

Для Markdown:

для жирного шрифта используете "*caption*"

для курсива "_caption_"

Пример:

Отправка файлов внутри Telegram

В методах 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 и т.д., как описано выше.

API ВКонтакте

Работает только на тарифе "Премиум"

Отправка сообщения

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 стикера (необязательный параметр)

API AmoCRM

Переместить сделку по воронке

amo_change_state(status_id, lead_id=None)

где status_id — id этапа воронки, на который надо перенести бота, lead_id — id сделки, котору необходимо передвинуть(необязательный параметр, по умолчанию берется из переменной amo_lead_id).

Ид состояния необходимо взять из исходников страницы AmoCRM: