{"id":17270749,"url":"https://github.com/hawry/messaging","last_synced_at":"2025-03-26T12:24:06.938Z","repository":{"id":150053949,"uuid":"138937934","full_name":"hawry/messaging","owner":"hawry","description":"Java API for easy serialization/deserialization of Facebooks Messenger Platform API","archived":false,"fork":false,"pushed_at":"2018-07-11T19:20:10.000Z","size":101,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-31T13:28:45.667Z","etag":null,"topics":["java","java-api-facebook","java-api-messenger","java-library","messenger","messenger-api","messenger-bot","messenger-chatbot","messenger-chatbots","messenger-platform"],"latest_commit_sha":null,"homepage":null,"language":"Java","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/hawry.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-27T22:09:12.000Z","updated_at":"2023-03-05T02:38:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"dbc288e2-ad5e-4676-9606-dffcf285e8bb","html_url":"https://github.com/hawry/messaging","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hawry%2Fmessaging","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hawry%2Fmessaging/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hawry%2Fmessaging/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hawry%2Fmessaging/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hawry","download_url":"https://codeload.github.com/hawry/messaging/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245651087,"owners_count":20650232,"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":["java","java-api-facebook","java-api-messenger","java-library","messenger","messenger-api","messenger-bot","messenger-chatbot","messenger-chatbots","messenger-platform"],"created_at":"2024-10-15T08:21:07.748Z","updated_at":"2025-03-26T12:24:01.931Z","avatar_url":"https://github.com/hawry.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/Hawry/messaging.svg?branch=master)](https://travis-ci.org/Hawry/messaging)\n\n# Messaging\n\nJava API for easy serialization and de-serialization of Facebooks Messenger Platform API. Currently being actively developed.\n\n## Supported FB Graph API versions\n\n## Install\n\n### Gradle\n\nMessaging uses the JitPack service, add the following to your `build.gradle`:\n\n```gradle\nrepositories {\n  ...\n  maven { \n    name \"jitpack\"\n    url \"https://jitpack.io\"\n  }\n  ...\n}\n\ndependencies {\n  implementation 'com.github.hawry:messaging:0.3.0'\n}\n```\n\nNote that you can replace the `0.3.0` with a specific release tag or any other short commit hash.\n\n### Maven\n\n```xml\n\u003crepositories\u003e\n  \u003crepository\u003e\n      \u003cid\u003ejitpack.io\u003c/id\u003e\n      \u003curl\u003ehttps://jitpack.io\u003c/url\u003e\n  \u003c/repository\u003e\n\u003c/repositories\u003e\n```\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.github.hawry\u003c/groupId\u003e\n    \u003cartifactId\u003emessaging\u003c/artifactId\u003e\n    \u003cversion\u003e0.3.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### Other\n\n## Usage\n\n### Usage example\n\n#### Receive a webhook event\n\n```java\nimport net.hawry.messaging.core.webhook;\n\n/* ... */\n// the following is linebreaked for brevity and won't compile\nString payload = \"{\n  'object':'page',\n  'entry':[\n    {\n      'id':'\u003cPAGE_ID\u003e',\n      'time':1458692752478,\n      'messaging':[\n        {\n          'sender':{\n            'id':'\u003cPSID\u003e'\n          },\n          'recipient':{\n            'id':'\u003cPAGE_ID\u003e'\n          },\n          'message':{\n            'mid':'mid.1457764197618:41d102a3e1ae206a38',\n            'text':'hello, world!',\n          }\n        }\n      ]\n    }\n  ]\n}\";\n\ntry {\n  Event event = Event.fromJson(payload);\n\n  System.out.println(event.getObject()); // results in 'page'\n  for (Entry entry : event.getEntries()) {\n    System.out.println(entry.getId()); // results in \u003cPAGE_ID\u003e\n    Messaging m = entry.getMessaging(); // even though it's an array in the JSON-string, according to the docs there will only ever be a single messaging-object\n    System.out.println(m.getSender().getId()); // \u003cPSID\u003e\n    System.out.println(m.getRecipient().getId()); // \u003cPAGE_ID\u003e\n    \n    WebhookMessage msg = m.getMessage();\n    System.out.println(msg.getMessageId()); // $mid.1457764197618:41d102a3e1ae206a38\n    System.out.println(msg.getText()); // hello, world\n\n  }\n} catch (InvalidJsonException e) {\n  e.printStackTrace();\n}\n\n```\n\n### Mark message as 'seen'\n\n```java\nimport net.hawry.messaging.core.Message;\nimport net.hawry.messaging.core.MessageBuilder;\n\n/* ... */\n\nMessageBuilder builder = new MessageBuilder();\nMessage msg = builder.setRecipient(new Participant(\"123\"))\n                .setSenderAction(SenderActionType.MARK_SEEN)\n                .create();\n\nString json;\n\ntry {\n  json = msg.toJson();\n} catch (MissingRequiredFieldsException e) {\n  e.printStackTrace();\n}\n\nSystem.out.println(json); /* results in {\"recipient\": {\"id\": \"123\"}, \"sender_action\": \"mark_seen\"}\n\n/* ... */\n```\n\n## License\n\nMIT\n\n## Contributions\n\nContributions welcome, fork the project and create a pull request.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhawry%2Fmessaging","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhawry%2Fmessaging","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhawry%2Fmessaging/lists"}