{"id":22169171,"url":"https://github.com/messente/messente-api-java","last_synced_at":"2025-03-24T17:22:00.881Z","repository":{"id":39959360,"uuid":"173282551","full_name":"messente/messente-api-java","owner":"messente","description":"Messente API library: https://bintray.com/messente/messente-api/messente-api","archived":false,"fork":false,"pushed_at":"2025-03-24T14:34:04.000Z","size":895,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-24T15:31:19.790Z","etag":null,"topics":["number-lookup","omnichannel","phonebook","statistics"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/messente.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2019-03-01T10:25:29.000Z","updated_at":"2025-01-22T15:00:48.000Z","dependencies_parsed_at":"2024-06-24T19:13:54.837Z","dependency_job_id":"d1367ac8-290a-449a-9534-b5992804351a","html_url":"https://github.com/messente/messente-api-java","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/messente%2Fmessente-api-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/messente%2Fmessente-api-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/messente%2Fmessente-api-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/messente%2Fmessente-api-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/messente","download_url":"https://codeload.github.com/messente/messente-api-java/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245315470,"owners_count":20595252,"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":["number-lookup","omnichannel","phonebook","statistics"],"created_at":"2024-12-02T06:29:04.598Z","updated_at":"2025-03-24T17:22:00.856Z","avatar_url":"https://github.com/messente.png","language":"Java","readme":"# Messente API Library\n\n- Messente API version: 2.0.0\n- Java artifact version: 4.4.0\n\n[Messente](https://messente.com) is a global provider of messaging and user verification services.  * Send and receive SMS, Viber, WhatsApp and Telegram messages. * Manage contacts and groups. * Fetch detailed info about phone numbers. * Blacklist phone numbers to make sure you\u0026#39;re not sending any unwanted messages.  Messente builds [tools](https://messente.com/documentation) to help organizations connect their services to people anywhere in the world.\n\n## Installation\n\nInstall Messente API library via Maven, Gradle, Ivy or manual build.\n\n### Gradle\n\n```groovy\ndependencies {\n    implementation 'com.messente.api:messente-api:4.4.0'\n}\n```\n\n### Maven\n\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.messente.api\u003c/groupId\u003e\n  \u003cartifactId\u003emessente-api\u003c/artifactId\u003e\n  \u003cversion\u003e4.4.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### Ivy\n\n```xml\n\u003cdependency org='com.messente.api' name='messente-api' rev='4.4.0'/\u003e\n```\n\n### Manual Build\n\nGenerate\n\n```shell\nmvn clean package\n```\n\nInstall\n\n- `target/messente-api-4.4.0.jar`\n- `target/lib/*.jar`\n\n## Features\n\nMessente API has the following features:\n\n- Omnichannel ([external docs](https://messente.com/documentation/omnichannel-api)),\n- Phonebook ([external docs](https://messente.com/documentation/phonebook-api)).\n\nMessente API Library provides the operations described below to access the features.\n\n### BlacklistApi\n\n1. Adds a phone number to the blacklist [`addToBlacklist`](docs/BlacklistApi.md#addtoblacklist)\n1. Deletes a phone number from the blacklist [`deleteFromBlacklist`](docs/BlacklistApi.md#deletefromblacklist)\n1. Returns all blacklisted phone numbers [`fetchBlacklist`](docs/BlacklistApi.md#fetchblacklist)\n1. Checks if a phone number is blacklisted [`isBlacklisted`](docs/BlacklistApi.md#isblacklisted)\n\n### BulkMessagingApi\n\n1. Sends a bulk Omnimessage [`sendBulkOmnimessage`](docs/BulkMessagingApi.md#sendbulkomnimessage)\n\n### ContactsApi\n\n1. Adds a contact to a group [`addContactToGroup`](docs/ContactsApi.md#addcontacttogroup)\n1. Creates a new contact [`createContact`](docs/ContactsApi.md#createcontact)\n1. Deletes a contact [`deleteContact`](docs/ContactsApi.md#deletecontact)\n1. Lists a contact [`fetchContact`](docs/ContactsApi.md#fetchcontact)\n1. Lists groups of a contact [`fetchContactGroups`](docs/ContactsApi.md#fetchcontactgroups)\n1. Returns all contacts [`fetchContacts`](docs/ContactsApi.md#fetchcontacts)\n1. Removes a contact from a group [`removeContactFromGroup`](docs/ContactsApi.md#removecontactfromgroup)\n1. Updates a contact [`updateContact`](docs/ContactsApi.md#updatecontact)\n\n### DeliveryReportApi\n\n1. Retrieves the delivery report for the Omnimessage [`retrieveDeliveryReport`](docs/DeliveryReportApi.md#retrievedeliveryreport)\n\n### GroupsApi\n\n1. Creates a new group with the provided name [`createGroup`](docs/GroupsApi.md#creategroup)\n1. Deletes a group [`deleteGroup`](docs/GroupsApi.md#deletegroup)\n1. Lists a group [`fetchGroup`](docs/GroupsApi.md#fetchgroup)\n1. Returns all groups [`fetchGroups`](docs/GroupsApi.md#fetchgroups)\n1. Updates a group with the provided name [`updateGroup`](docs/GroupsApi.md#updategroup)\n\n### NumberLookupApi\n\n1. Requests info about phone numbers [`fetchInfo`](docs/NumberLookupApi.md#fetchinfo)\n\n### OmnimessageApi\n\n1. Cancels a scheduled Omnimessage [`cancelScheduledMessage`](docs/OmnimessageApi.md#cancelscheduledmessage)\n1. Sends an Omnimessage [`sendOmnimessage`](docs/OmnimessageApi.md#sendomnimessage)\n\n### StatisticsApi\n\n1. Requests statistics reports for each country [`createStatisticsReport`](docs/StatisticsApi.md#createstatisticsreport)\n\n## Auth\n\n**Type**: HTTP basic authentication\n\nRead the [external getting-started article](https://messente.com/documentation/getting-started) which explains API keys and Sender ID logic.\n\n## Getting started: sending an omnimessage\n\n```java\nimport com.messente.ApiClient;\nimport com.messente.ApiException;\nimport com.messente.api.*;\nimport com.messente.auth.HttpBasicAuth;\n\nimport java.util.Arrays;\nimport java.util.List;\n\n// repositories { mavenCentral() }\n// dependencies { implementation 'com.messente.api:messente-api' }\n\npublic class Main {\n    public static void main(String[] args) {\n        ApiClient apiClient = new ApiClient();\n        OmnimessageApi apiInstance = new OmnimessageApi(apiClient);\n\n        HttpBasicAuth basicAuth = (HttpBasicAuth) apiClient.getAuthentication(\"basicAuth\");\n        basicAuth.setUsername(\"YOUR_MESSENTE_API_USERNAME\");\n        basicAuth.setPassword(\"YOUR_MESSENTE_API_PASSWORD\");\n\n        Viber viber = new Viber();\n        viber.text(\"hello viber\");\n        viber.sender(\"\u003csender name (optional)\u003e\");\n        OmnimessageMessagesInner viberOmnimessageInner = new OmnimessageMessagesInner(viber);\n        viberOmnimessageInner.setActualInstance(viber);\n\n        SMS sms = new SMS();\n        sms.text(\"hello sms\");\n        sms.sender(\"\u003csender name (optional)\u003e\");\n        OmnimessageMessagesInner smsOmnimessageInner = new OmnimessageMessagesInner(sms);\n        smsOmnimessageInner.setActualInstance(sms);\n\n        WhatsAppParameter whatsAppParameter = new WhatsAppParameter();\n        whatsAppParameter.type(\"text\");\n        whatsAppParameter.text(\"hello whatsapp\");\n\n        WhatsAppComponent whatsAppComponent = new WhatsAppComponent();\n        whatsAppComponent.type(\"body\");\n        whatsAppComponent.setParameters(List.of(whatsAppParameter));\n\n        WhatsAppTemplate whatsAppTemplate = new WhatsAppTemplate();\n        whatsAppTemplate.name(\"\u003ctemplate_name\u003e\");\n        whatsAppTemplate.language(new WhatsAppLanguage().code(\"\u003clanguage_code\u003e\"));\n        whatsAppTemplate.setComponents(List.of(whatsAppComponent));\n\n        WhatsApp whatsApp = new WhatsApp();\n        whatsApp.sender(\"\u003csender name (optional)\u003e\");\n        whatsApp.template(whatsAppTemplate);\n\n        OmnimessageMessagesInner whatsAppOmnimessageInner = new OmnimessageMessagesInner(whatsApp);\n        whatsAppOmnimessageInner.setActualInstance(whatsApp);\n\n        Omnimessage omnimessage = new Omnimessage();\n        omnimessage.setMessages(\n                Arrays.asList(\n                        smsOmnimessageInner,\n                        viberOmnimessageInner,\n                        whatsAppOmnimessageInner\n                )\n        );\n        omnimessage.setTo(\"\u003crecipient_phone_number\u003e\");\n\n        try {\n            OmniMessageCreateSuccessResponse result = apiInstance.sendOmnimessage(omnimessage);\n            System.out.println(result);\n        } catch (ApiException e) {\n            System.err.println(\"Exception when calling sendOmnimessage\");\n            System.err.println(e.getResponseBody());\n        }\n    }\n}\n\n```\n\n## License\n\n[Apache-2.0](http://www.apache.org/licenses/LICENSE-2.0.html)\n\n## Terms\n\n[https://messente.com/terms-and-conditions](https://messente.com/terms-and-conditions)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmessente%2Fmessente-api-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmessente%2Fmessente-api-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmessente%2Fmessente-api-java/lists"}