{"id":25097266,"url":"https://github.com/messagemedia/conversations-ruby-sdk","last_synced_at":"2025-09-07T06:09:47.306Z","repository":{"id":79431094,"uuid":"135969723","full_name":"messagemedia/conversations-ruby-sdk","owner":"messagemedia","description":"MessageMedia Ruby SDK for sending and receiving messages via OTT messaging services","archived":false,"fork":false,"pushed_at":"2021-01-22T07:44:43.000Z","size":49,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-02T02:46:34.505Z","etag":null,"topics":["api","conversations","messaging","ott","ruby"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/messagemedia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-06-04T04:15:55.000Z","updated_at":"2021-01-22T07:44:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"dff6193c-39db-4770-bda0-773182235b37","html_url":"https://github.com/messagemedia/conversations-ruby-sdk","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/messagemedia/conversations-ruby-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/messagemedia%2Fconversations-ruby-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/messagemedia%2Fconversations-ruby-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/messagemedia%2Fconversations-ruby-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/messagemedia%2Fconversations-ruby-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/messagemedia","download_url":"https://codeload.github.com/messagemedia/conversations-ruby-sdk/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/messagemedia%2Fconversations-ruby-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274002148,"owners_count":25205392,"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","status":"online","status_checked_at":"2025-09-07T02:00:09.463Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["api","conversations","messaging","ott","ruby"],"created_at":"2025-02-07T17:31:07.819Z","updated_at":"2025-09-07T06:09:47.269Z","avatar_url":"https://github.com/messagemedia.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MessageMedia Conversations Ruby SDK\n[![Gem Version](https://badge.fury.io/rb/messagemedia_conversations_sdk.svg)](https://badge.fury.io/rb/messagemedia_conversations_sdk)\n\n⚠️ **Please note the API documented is in beta and is subject to breaking changes in the short term.** ⚠️\n\nThe MessageMedia Conversations API allows users to communicate by sending and receiving messages via OTT messaging services. This feature is disabled by default. To enable it, you don't need to make any changes to your application, just an account configuration change by MessageMedia's support team (support@messagemedia.com).\n\n## ⭐️ Installing via RubyGems\nRun the following command to install the SDK via RubyGems:\n* `gem install messagemedia-conversations-sdk`\n\n## 🎬 Get Started\nIt's easy to get started. Simply enter the API Key and secret you obtained from the [MessageMedia Developers Portal](https://developers.messagemedia.com) into the code snippet below.\n\n### 🚀 Configure an account\n```ruby\nrequire 'message_media_conversations'\nrequire 'pp'\n\n# Configuration parameters and credentials\nbasic_auth_user_name = 'basic_auth_user_name' # The username to use with basic authentication\nbasic_auth_password = 'basic_auth_password' # The password to use with basic authentication\n\nclient = MessageMediaConversations::MessageMediaConversationsClient.new(\n  basic_auth_user_name: basic_auth_user_name,\n  basic_auth_password: basic_auth_password\n)\n\nconfiguration_controller = client.configuration\nrequest = MessageMediaConversations::ConfigureAccountRequest.new(\"http://accounts-domain.com/callback\", \"Rainbow Serpent Festival\")\n\nresult = configuration_controller.create_configure_account(request)\npp result\n\n```\n\n### 🔐 Facebook Authorization\n```ruby\nrequire 'message_media_conversations'\nrequire 'pp'\n\n# Configuration parameters and credentials\nbasic_auth_user_name = 'basic_auth_user_name' # The username to use with basic authentication\nbasic_auth_password = 'basic_auth_password' # The password to use with basic authentication\n\nclient = MessageMediaConversations::MessageMediaConversationsClient.new(\n  basic_auth_user_name: basic_auth_user_name,\n  basic_auth_password: basic_auth_password\n)\n\nfacebook_controller = client.facebook\n\nresult = facebook_controller.get_facebook_authorisation_url()\npp result\n\n```\n\n### ⬇️ Get Facebook pages\n```ruby\nrequire 'message_media_conversations'\nrequire 'pp'\n\n# Configuration parameters and credentials\nbasic_auth_user_name = 'basic_auth_user_name' # The username to use with basic authentication\nbasic_auth_password = 'basic_auth_password' # The password to use with basic authentication\n\nfacebook_controller = client.facebook\n\nresult = facebook_controller.get_facebook_pages()\npp result\n\n```\n\n### ♻️ Integrate Facebook page\nYou can get the facebookPageId by looking at the response of the Get Facebook pages example.\n```ruby\nrequire 'message_media_conversations'\nrequire 'pp'\n\n# Configuration parameters and credentials\nbasic_auth_user_name = 'basic_auth_user_name' # The username to use with basic authentication\nbasic_auth_password = 'basic_auth_password' # The password to use with basic authentication\n\nfacebook_controller = client.facebook\n\nfacebook_page_id = 'facebookPageId'\nresult = facebook_controller.create_integrate_facebook_page(facebook_page_id)\npp result\n\n```\n\n### 👤 Get users\n```ruby\nrequire 'message_media_conversations'\nrequire 'pp'\n\n# Configuration parameters and credentials\nbasic_auth_user_name = 'basic_auth_user_name' # The username to use with basic authentication\nbasic_auth_password = 'basic_auth_password' # The password to use with basic authentication\n\nappUsers_controller = client.app_users\nresult = appUsers_controller.get_app_users()\npp result\n\n```\n\n### 💬 Get user messages\nYou can get the appUserId from the response of the Get users example.\n```ruby\nrequire 'message_media_conversations'\nrequire 'pp'\n\n# Configuration parameters and credentials\nbasic_auth_user_name = 'basic_auth_user_name' # The username to use with basic authentication\nbasic_auth_password = 'basic_auth_password' # The password to use with basic authentication\n\nappUsers_controller = client.app_users\napp_user_id = 'appUserId'\n\nresult = appUsers_controller.get_app_user_messages(app_user_id)\npp result\n\n```\n\n### ✉️ Send message to user\nYou can get the appUserId from the response of the Get users example.\n```ruby\nrequire 'message_media_conversations'\nrequire 'pp'\n\n# Configuration parameters and credentials\nbasic_auth_user_name = 'basic_auth_user_name' # The username to use with basic authentication\nbasic_auth_password = 'basic_auth_password' # The password to use with basic authentication\n\nappUsers_controller = client.app_users\napp_user_id = 'appUserId'\nmessage = BaseMessageDto.new({\"key\":\"value\"})\n\nappUsers_controller.create_send_message(app_user_id, message)\n\n```\n\n## 📕 Documentation\nCheck out the [full API documentation](DOCUMENTATION.md) for more detailed information.\n\n## 😕 Need help?\nPlease contact developer support at developers@messagemedia.com or check out the developer portal at [developers.messagemedia.com](https://developers.messagemedia.com/)\n\n## 📃 License\nApache License. See the [LICENSE](LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmessagemedia%2Fconversations-ruby-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmessagemedia%2Fconversations-ruby-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmessagemedia%2Fconversations-ruby-sdk/lists"}