telebot-methods.h

Go to the documentation of this file.

/*
 * telebot
 *
 * Copyright (c) 2015 Elmurod Talipov.
 *
 * Licensed under the Apache License, Version 2.0 (the License);
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 
#ifndef __TELEBOT_METHODS_H__
#define __TELEBOT_METHODS_H__
 
#include <stdbool.h>
#include "telebot-common.h"
#include "telebot-types.h"
#include "telebot-core.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
telebot_error_e telebot_create(telebot_handler_t *handle, char *token);
 
telebot_error_e telebot_destroy(telebot_handler_t handle);
 
telebot_error_e telebot_set_proxy(telebot_handler_t handle, char *addr, char *auth);
 
telebot_error_e telebot_get_proxy(telebot_handler_t handle, char **addr);
 
telebot_error_e telebot_get_updates(telebot_handler_t handle, int offset,
        int limit, int timeout, telebot_update_type_e allowed_updates[],
        int allowed_updates_count, telebot_update_t **updates, int *count);
 
telebot_error_e telebot_put_updates(telebot_update_t *updates, int count);
 
 
telebot_error_e telebot_set_webhook(telebot_handler_t handle, char *url,
    char *certificate, int max_connections,telebot_update_type_e allowed_updates[],
    int allowed_updates_count);
 
telebot_error_e telebot_delete_webhook(telebot_handler_t handle);
 
 
telebot_error_e telebot_get_webhook_info(telebot_handler_t handle,
        telebot_webhook_info_t *info);
 
telebot_error_e telebot_put_webhook_info(telebot_webhook_info_t *info);
 
telebot_error_e telebot_get_me(telebot_handler_t handle, telebot_user_t *me);
 
telebot_error_e telebot_put_me(telebot_user_t *me);
 
telebot_error_e telebot_put_user(telebot_user_t *user);
 
telebot_error_e telebot_send_message(telebot_handler_t handle, long long int chat_id,
    const char *text, const char *parse_mode, bool disable_web_page_preview,
    bool disable_notification, int reply_to_message_id, const char *reply_markup);
 
telebot_error_e telebot_forward_message(telebot_handler_t handle, long long int chat_id,
    long long int from_chat_id, bool disable_notification, int message_id);
 
telebot_error_e telebot_send_photo(telebot_handler_t handle, long long int chat_id,
    const char *photo, bool is_file, const char *caption, const char *parse_mode,
    bool disable_notification, int reply_to_message_id, const char *reply_markup);
 
 
telebot_error_e telebot_send_audio(telebot_handler_t handle, long long int chat_id,
    const char *audio, bool is_file, const char *caption, const char *parse_mode,
    int duration, const char *performer, const char *title, const char *thumb,
    bool disable_notification, int reply_to_message_id, const char *reply_markup);
 
telebot_error_e telebot_send_document(telebot_handler_t handle, long long int chat_id,
    const char *document, bool is_file, const char *thumb, const char *caption,
    const char *parse_mode, bool disable_notification, int reply_to_message_id,
    const char *reply_markup);
 
telebot_error_e telebot_send_video(telebot_handler_t handle, long long int chat_id,
    const char *video, bool is_file, int duration, int width, int height,
    const char *thumb, const char *caption, const char *parse_mode,
    bool supports_streaming, bool disable_notification, int reply_to_message_id,
    const char *reply_markup);
 
telebot_error_e telebot_send_animation(telebot_handler_t handle, long long int chat_id,
    const char *animation, bool is_file, int duration, int width, int height,
    const char *thumb, const char *caption, const char *parse_mode,
    bool disable_notification, int reply_to_message_id, const char *reply_markup);
 
 
telebot_error_e telebot_send_voice(telebot_handler_t handle, long long int chat_id,
    const char *voice, bool is_file, const char *caption, const char *parse_mode,
    int duration, bool disable_notification, int reply_to_message_id,
    const char *reply_markup);
 
telebot_error_e telebot_send_video_note(telebot_handler_t handle, long long int chat_id,
    char *video_note, bool is_file, int duration, int length, const char *thumb,
    bool disable_notification, int reply_to_message_id, const char *reply_markup);
 
telebot_error_e telebot_send_media_group(
    telebot_handler_t handle,
    long long int chat_id,
    char *media_paths[],
    int count,
    bool disable_notification,
    int reply_to_message_id);
 
telebot_error_e telebot_send_location(telebot_handler_t handle, long long int chat_id,
    float latitude, float longitude, int live_period, bool disable_notification,
    int reply_to_message_id, const char *reply_markup);
 
telebot_error_e telebot_edit_message_live_location(telebot_handler_t handle,
    long long int chat_id, int message_id, const char *inline_message_id,
    float latitude, float longitude, const char *reply_markup);
 
telebot_error_e telebot_stop_message_live_location(telebot_handler_t handle,
    long long int chat_id, int message_id, char *inline_message_id,
    const char *reply_markup);
 
telebot_error_e telebot_send_venue(telebot_handler_t handle, long long int chat_id,
    float latitude, float longitude, const char *title, const char *address,
    const char *foursquare_id, const char *foursquare_type, bool disable_notification,
    int reply_to_message_id, const char *reply_markup);
 
telebot_error_e telebot_send_contact(telebot_handler_t handle, long long int chat_id,
    const char *phone_number, const char *first_name, const char *last_name,
    const char *vcard, bool disable_notification, int reply_to_message_id,
    const char *reply_markup);
 
telebot_error_e telebot_send_poll(telebot_handler_t handle, long long int chat_id,
    const char *question, const char **options, int count_options, bool is_anonymous,
    const char *type, bool allows_multiple_answers, int correct_option_id, bool is_closed,
    bool disable_notification, int reply_to_message_id, const char *reply_markup);
 
telebot_error_e telebot_send_dice(telebot_handler_t handle, long long int chat_id,
    bool disable_notification, int reply_to_message_id, const char *reply_markup);
 
telebot_error_e telebot_send_chat_action(telebot_handler_t handle, long long int chat_id,
    char *action);
 
telebot_error_e telebot_get_user_profile_photos(telebot_handler_t handle,
        int user_id, int offset, int limit, telebot_user_profile_photos_t *photos);
 
telebot_error_e telebot_put_user_profile_photos(telebot_user_profile_photos_t *photos);
 
telebot_error_e telebot_get_user_profile_audios(telebot_handler_t handle,
    long long int user_id, int offset, int limit, telebot_user_profile_audios_t *audios);
 
telebot_error_e telebot_put_user_profile_audios(telebot_user_profile_audios_t *audios);
 
telebot_error_e telebot_set_my_profile_photo(telebot_handler_t handle,
    const char *photo);
 
telebot_error_e telebot_remove_my_profile_photo(telebot_handler_t handle,
    const char *photo_id);
 
telebot_error_e telebot_get_business_connection(telebot_handler_t handle,
    const char *business_connection_id, telebot_business_connection_t *connection);
 
telebot_error_e telebot_put_business_connection(telebot_business_connection_t *connection);
 
telebot_error_e telebot_get_user_chat_boosts(telebot_handler_t handle,
    long long int chat_id, long long int user_id, telebot_user_chat_boosts_t *boosts);
 
telebot_error_e telebot_put_user_chat_boosts(telebot_user_chat_boosts_t *boosts);
 
telebot_error_e telebot_download_file(telebot_handler_t handle, const char *file_id,
    const char *path);
 
telebot_error_e telebot_kick_chat_member(telebot_handler_t handle, long long int chat_id,
    int user_id, long until_date);
 
telebot_error_e telebot_unban_chat_member(telebot_handler_t handle, long long int chat_id,
     int user_id);
 
telebot_error_e telebot_restrict_chat_member(telebot_handler_t handle,
    long long int chat_id, int user_id, long until_date, bool can_send_messages,
    bool can_send_media_messages, bool can_send_polls, bool can_send_other_messages,
    bool can_add_web_page_previews, bool can_change_info, bool can_invite_users,
    bool can_pin_messages);
 
telebot_error_e telebot_promote_chat_member(telebot_handler_t handle,
    long long int chat_id, int user_id, bool can_change_info, bool can_post_messages,
    bool can_edit_messages, bool can_delete_messages, bool can_invite_users,
    bool can_restrict_members, bool can_pin_messages, bool can_promote_members);
 
telebot_error_e telebot_set_chat_admin_custom_title(telebot_handler_t handle,
    long long int chat_id, int user_id, const char *custom_title);
 
telebot_error_e telebot_set_chat_permissions(telebot_handler_t handle,
    long long int chat_id, bool can_send_messages, bool can_send_media_messages,
    bool can_send_polls, bool can_send_other_messages, bool can_add_web_page_previews,
    bool can_change_info, bool can_invite_users, bool can_pin_messages);
 
telebot_error_e telebot_export_chat_invite_link(telebot_handler_t handle,
    long long int chat_id, char **invite_link);
 
telebot_error_e telebot_set_chat_photo(telebot_handler_t handle, long long int chat_id,
    const char *photo);
 
telebot_error_e telebot_delete_chat_photo(telebot_handler_t handle, long long int chat_id);
 
telebot_error_e telebot_set_chat_title(telebot_handler_t handle, long long int chat_id,
    const char *title);
 
telebot_error_e telebot_set_chat_description(telebot_handler_t handle,
    long long int chat_id, const char *description);
 
telebot_error_e telebot_pin_chat_message(telebot_handler_t handle, long long int chat_id,
    int message_id, bool disable_notification);
 
telebot_error_e telebot_unpin_chat_message(telebot_handler_t handle, long long int chat_id);
 
telebot_error_e telebot_leave_chat(telebot_handler_t handle, long long int chat_id);
 
telebot_error_e telebot_get_chat(telebot_handler_t handle, long long int chat_id,
    telebot_chat_t *chat);
 
 
telebot_error_e  telebot_put_chat(telebot_chat_t *chat);
 
telebot_error_e telebot_get_chat_admins(telebot_handler_t handle, long long int chat_id,
    telebot_chat_member_t **admin, int *count);
 
telebot_error_e telebot_put_chat_admins(telebot_chat_member_t *admins, int count);
 
telebot_error_e telebot_get_chat_members_count(telebot_handler_t handle,
    long long int chat_id, int *count);
 
telebot_error_e telebot_get_chat_member(telebot_handler_t handle, long long int chat_id,
    int user_id, telebot_chat_member_t *member);
 
telebot_error_e telebot_put_chat_member(telebot_chat_member_t *member);
 
telebot_error_e telebot_set_chat_sticker_set(telebot_handler_t handle,
        long long int chat_id, const char *sticker_set_name);
 
telebot_error_e telebot_delete_chat_sticker_set(telebot_handler_t handle,
    long long int chat_id);
 
telebot_error_e telebot_answer_callback_query(telebot_handler_t handle,
    const char *callback_query_id, const char *text, bool show_alert,
    const char *url, int cache_time);
 
telebot_error_e telebot_set_my_commands(telebot_handler_t handle,
    telebot_bot_command_t commands[], int count);
 
telebot_error_e telebot_get_my_commands(telebot_handler_t handle,
    telebot_bot_command_t **commands, int *count);
 
telebot_error_e telebot_put_my_commands(telebot_bot_command_t *commands, int count);
 
telebot_error_e telebot_edit_message_text(telebot_handler_t handle,
    long long int chat_id, int message_id, const char *inline_message_id,
    const char *text, const char *parse_mode, bool disable_web_page_preview,
    const char *reply_markup);
 
telebot_error_e telebot_edit_message_caption(telebot_handler_t handle,
    long long int chat_id, int message_id, const char *inline_message_id,
    const char *caption, const char *parse_mode, const char *reply_markup);
 
telebot_error_e telebot_edit_message_reply_markup(telebot_handler_t handle,
    long long int chat_id, int message_id, const char *inline_message_id,
    const char *reply_markup);
 
telebot_error_e telebot_stop_poll(telebot_handler_t handle, long long int chat_id,
    int message_id, const char *reply_markup);
 
telebot_error_e telebot_delete_message(telebot_handler_t handle, long long int chat_id,
    int message_id);
 
telebot_error_e telebot_log_out(telebot_handler_t handle);
 
telebot_error_e telebot_close(telebot_handler_t handle);
 
telebot_error_e telebot_set_my_name(telebot_handler_t handle,
    const char *name, const char *language_code);
 
telebot_error_e telebot_get_my_name(telebot_handler_t handle,
    const char *language_code, char **name);
 
telebot_error_e telebot_set_my_description(telebot_handler_t handle,
    const char *description, const char *language_code);
 
telebot_error_e telebot_get_my_description(telebot_handler_t handle,
    const char *language_code, char **description);
 
telebot_error_e telebot_set_my_short_description(telebot_handler_t handle,
    const char *short_description, const char *language_code);
 
telebot_error_e telebot_get_my_short_description(telebot_handler_t handle,
    const char *language_code, char **short_description);
 
telebot_error_e telebot_set_chat_menu_button(telebot_handler_t handle,
    long long int chat_id, const char *menu_button);
 
telebot_error_e telebot_get_chat_menu_button(telebot_handler_t handle,
    long long int chat_id, char **menu_button);
 
telebot_error_e telebot_set_my_default_administrator_rights(telebot_handler_t handle,
    const char *rights, bool for_channels);
 
telebot_error_e telebot_get_my_default_administrator_rights(telebot_handler_t handle,
    bool for_channels, char **rights);
 
telebot_error_e telebot_delete_my_commands(telebot_handler_t handle,
    const char *scope, const char *language_code);
 
telebot_error_e telebot_copy_message(telebot_handler_t handle,
    long long int chat_id, long long int from_chat_id, int message_id,
    const char *caption, const char *parse_mode, const char *caption_entities,
    bool disable_notification, bool protect_content, int reply_to_message_id,
    bool allow_sending_without_reply, const char *reply_markup, int *message_id_out);
 
telebot_error_e telebot_copy_messages(telebot_handler_t handle,
    long long int chat_id, long long int from_chat_id, const char *message_ids,
    bool disable_notification, bool protect_content, bool remove_caption,
    int **message_ids_out, int *count);
 
telebot_error_e telebot_forward_messages(telebot_handler_t handle,
    long long int chat_id, long long int from_chat_id, const char *message_ids,
    bool disable_notification, bool protect_content, int **message_ids_out, int *count);
 
telebot_error_e telebot_delete_messages(telebot_handler_t handle,
    long long int chat_id, const char *message_ids);
 
telebot_error_e telebot_ban_chat_member(telebot_handler_t handle,
    long long int chat_id, int user_id, long until_date, bool revoke_messages);
 
telebot_error_e telebot_ban_chat_sender_chat(telebot_handler_t handle,
    long long int chat_id, long long int sender_chat_id);
 
telebot_error_e telebot_unban_chat_sender_chat(telebot_handler_t handle,
    long long int chat_id, long long int sender_chat_id);
 
telebot_error_e telebot_create_chat_invite_link(telebot_handler_t handle,
    long long int chat_id, const char *name, long expire_date, int member_limit,
    bool creates_join_request, telebot_chat_invite_link_t *invite_link);
 
telebot_error_e telebot_edit_chat_invite_link(telebot_handler_t handle,
    long long int chat_id, const char *invite_link_str, const char *name,
    long expire_date, int member_limit, bool creates_join_request,
    telebot_chat_invite_link_t *invite_link);
 
telebot_error_e telebot_revoke_chat_invite_link(telebot_handler_t handle,
    long long int chat_id, const char *invite_link_str, telebot_chat_invite_link_t *invite_link);
 
telebot_error_e telebot_put_chat_invite_link(telebot_chat_invite_link_t *invite_link);
 
telebot_error_e telebot_approve_chat_join_request(telebot_handler_t handle,
    long long int chat_id, int user_id);
 
telebot_error_e telebot_decline_chat_join_request(telebot_handler_t handle,
    long long int chat_id, int user_id);
 
telebot_error_e telebot_set_message_reaction(telebot_handler_t handle,
    long long int chat_id, int message_id, const char *reaction, bool is_big);
 
telebot_error_e telebot_edit_message_media(telebot_handler_t handle,
    long long int chat_id, int message_id, const char *inline_message_id,
    const char *media, const char *reply_markup);
 
#ifdef __cplusplus
}
#endif
 
#endif /* __TELEBOT_METHODS_H__ */