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>

#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_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_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_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);

#ifdef __cplusplus
}
#endif

#endif /* __TELEBOT_METHODS_H__ */