{"id":13509572,"url":"https://github.com/zhyu/nadia","last_synced_at":"2026-02-25T11:39:29.291Z","repository":{"id":36439352,"uuid":"40744380","full_name":"zhyu/nadia","owner":"zhyu","description":"Telegram Bot API Wrapper written in Elixir","archived":false,"fork":false,"pushed_at":"2023-03-29T20:57:22.000Z","size":277,"stargazers_count":365,"open_issues_count":21,"forks_count":78,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-03-04T16:18:40.206Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Elixir","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zhyu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2015-08-15T02:50:36.000Z","updated_at":"2024-12-23T16:33:51.000Z","dependencies_parsed_at":"2023-01-17T01:29:23.048Z","dependency_job_id":"eea17f78-b0a5-4444-9fa6-f9f23aaeee09","html_url":"https://github.com/zhyu/nadia","commit_stats":{"total_commits":206,"total_committers":40,"mean_commits":5.15,"dds":0.5631067961165048,"last_synced_commit":"e57b45d1d73be195604e56f4e08fe7ce757518b9"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhyu%2Fnadia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhyu%2Fnadia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhyu%2Fnadia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhyu%2Fnadia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zhyu","download_url":"https://codeload.github.com/zhyu/nadia/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246324105,"owners_count":20759077,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T02:01:09.776Z","updated_at":"2025-10-21T19:02:13.754Z","avatar_url":"https://github.com/zhyu.png","language":"Elixir","readme":"# Nadia\n\n[![Elixir CI](https://github.com/zhyu/nadia/actions/workflows/elixir.yml/badge.svg)](https://github.com/zhyu/nadia/actions/workflows/elixir.yml)\n[![Module Version](https://img.shields.io/hexpm/v/nadia.svg)](https://hex.pm/packages/nadia)\n[![Hex Docs](https://img.shields.io/badge/hex-docs-lightgreen.svg)](https://hexdocs.pm/nadia/)\n[![Total Download](https://img.shields.io/hexpm/dt/nadia.svg)](https://hex.pm/packages/nadia)\n[![License](https://img.shields.io/hexpm/l/nadia.svg)](https://github.com/zhyu/nadia/blob/master/LICENSE)\n[![Last Updated](https://img.shields.io/github/last-commit/zhyu/nadia.svg)](https://github.com/zhyu/nadia/commits/master)\n\nTelegram Bot API Wrapper written in Elixir ([document](https://hexdocs.pm/nadia/))\n\n## Installation\n\nAdd `:nadia` to your `mix.exs` dependencies:\n\n```elixir\ndef deps do\n  [\n    {:nadia, \"~\u003e 0.7.0\"}\n  ]\nend\n```\n\nAnd run `$ mix deps.get`.\n\n## Configuration\n\nIn `config/config.exs`, add your Telegram Bot token like [this](config/config.exs.example)\n\n```elixir\nconfig :nadia,\n  token: \"bot token\"\n```\n\nYou can also add an optional `recv_timeout` in seconds (defaults to 5s):\n\n```elixir\nconfig :nadia,\n  recv_timeout: 10\n```\n\nYou can also add a proxy support:\n\n```elixir\nconfig :nadia,\n  proxy: \"http://proxy_host:proxy_port\", # or {:socks5, 'proxy_host', proxy_port}\n  proxy_auth: {\"user\", \"password\"},\n  ssl: [versions: [:'tlsv1.2']]\n```\n\nYou can also configure the the base url for the api if you need to for some\nreason:\n\n```elixir\nconfig :nadia,\n  # Telegram API. Default: https://api.telegram.org/bot\n  base_url: \"http://my-own-endpoint.com/whatever/\",\n\n  # Telegram Graph API. Default: https://api.telegra.ph\n  graph_base_url: \"http://my-own-endpoint.com/whatever/\"\n```\n\nEnvironment variables may be used as well:\n\n```elixir\nconfig :nadia,\n  token: {:system, \"ENVVAR_WITH_MYAPP_TOKEN\", \"default_value_if_needed\"}\n```\n\n## Usage\n\n### `get_me`\n\n```elixir\niex\u003e Nadia.get_me\n{:ok,\n %Nadia.Model.User{first_name: \"Nadia\", id: 666, last_name: nil,\n  username: \"nadia_bot\"}}\n```\n\n### `get_updates`\n\n```elixir\niex\u003e Nadia.get_updates limit: 5\n{:ok, []}\n\niex\u003e {:ok,\n [%Nadia.Model.Update{callback_query: nil, chosen_inline_result: nil,\n   edited_message: nil, inline_query: nil,\n   message: %Nadia.Model.Message{audio: nil, caption: nil,\n    channel_chat_created: nil,\n    chat: %Nadia.Model.Chat{first_name: \"Nadia\", id: 123,\n     last_name: \"TheBot\", title: nil, type: \"private\", username: \"nadia_the_bot\"},\n    contact: nil, date: 1471208260, delete_chat_photo: nil, document: nil,\n    edit_date: nil, entities: nil, forward_date: nil, forward_from: nil,\n    forward_from_chat: nil,\n    from: %Nadia.Model.User{first_name: \"Nadia\", id: 123,\n     last_name: \"TheBot\", username: \"nadia_the_bot\"}, group_chat_created: nil,\n    left_chat_member: nil, location: nil, message_id: 543,\n    migrate_from_chat_id: nil, migrate_to_chat_id: nil, new_chat_member: nil,\n    new_chat_photo: [], new_chat_title: nil, photo: [], pinned_message: nil,\n    reply_to_message: nil, sticker: nil, supergroup_chat_created: nil,\n    text: \"rew\", venue: nil, video: nil, voice: nil}, update_id: 98765}]}\n```\n\n### `send_message`\n\n```elixir\niex\u003e case Nadia.send_message(tlg_id, \"The message text goes here\") do\n  {:ok, _result} -\u003e\n    :ok\n  {:error, %Nadia.Model.Error{reason: \"Please wait a little\"}} -\u003e\n    :wait\n  end\n\n:ok\n```\n\nRefer to [Nadia document](https://hexdocs.pm/nadia/) and [Telegram Bot API document](https://core.telegram.org/bots/api) for more details.\n\n## Copyright and License\n\nCopyright (c) 2015 Yu Zhang\n\nThis library licensed under the [MIT license](./LICENSE.md).\n","funding_links":[],"categories":["Third Party APIs","Telegram Libraries"],"sub_categories":["Elixir"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhyu%2Fnadia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhyu%2Fnadia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhyu%2Fnadia/lists"}