{"id":19156918,"url":"https://github.com/bertrandmartel/bboxapi-voicemail","last_synced_at":"2025-06-29T13:35:01.997Z","repository":{"id":94807814,"uuid":"99049510","full_name":"bertrandmartel/bboxapi-voicemail","owner":"bertrandmartel","description":"Experimental Java/Android client library for unofficial Bbox VoiceMail API","archived":false,"fork":false,"pushed_at":"2017-08-02T17:16:44.000Z","size":76,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-03T20:12:24.956Z","etag":null,"topics":["api-client","bbox","bouygues","gateway-api","java-library"],"latest_commit_sha":null,"homepage":"","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/bertrandmartel.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-08-01T22:52:02.000Z","updated_at":"2023-01-24T10:05:20.000Z","dependencies_parsed_at":"2023-03-09T19:15:49.862Z","dependency_job_id":null,"html_url":"https://github.com/bertrandmartel/bboxapi-voicemail","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bertrandmartel%2Fbboxapi-voicemail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bertrandmartel%2Fbboxapi-voicemail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bertrandmartel%2Fbboxapi-voicemail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bertrandmartel%2Fbboxapi-voicemail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bertrandmartel","download_url":"https://codeload.github.com/bertrandmartel/bboxapi-voicemail/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240241803,"owners_count":19770463,"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":["api-client","bbox","bouygues","gateway-api","java-library"],"created_at":"2024-11-09T08:36:24.026Z","updated_at":"2025-02-22T21:43:19.460Z","avatar_url":"https://github.com/bertrandmartel.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bbox Voicemail API #\n\n[![Build Status](https://travis-ci.org/bertrandmartel/bboxapi-voicemail.svg)](https://travis-ci.org/bertrandmartel/bboxapi-voicemail)\n[![Download](https://api.bintray.com/packages/bertrandmartel/maven/bboxapi-voicemail/images/download.svg) ](https://bintray.com/bertrandmartel/maven/bboxapi-voicemail/_latestVersion)\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/fr.bmartel/bboxapi-voicemail/badge.svg)](https://maven-badges.herokuapp.com/maven-central/fr.bmartel/bboxapi-voicemail)\n[![Javadoc](http://javadoc-badge.appspot.com/fr.bmartel/bboxapi-voicemail.svg?label=javadoc)](http://javadoc-badge.appspot.com/fr.bmartel/bboxapi-voicemail)\n[![License](http://img.shields.io/:license-mit-blue.svg)](LICENSE.md)\n\n**Experimental** Java/Android client library for unofficial [Bbox VoiceMail API](https://www.messagerievocale.bbox.bouyguestelecom.fr/)\n\nMost of these API are using web scraping. Page content may change in the future so it can be deprecated at any time. [Create an issue](https://github.com/bertrandmartel/bboxapi-voicemail/issues/new) if you notice something broken. \n\n## API List\n\n| description     | api          |       \n|--------------|---------|\n| get welcome message  | [`getWelcomeMessage(int id, String fileDest)`](./examples/src/main/java/fr/bmartel/bboxapi/voicemail/examples/request/GetWelcomeMessage.java) | \n| upload welcome message  | [`uploadWelcomeMessage(String filePath, int messageId, int selectedId)`](./examples/src/main/java/fr/bmartel/bboxapi/voicemail/examples/action/UploadWelcomeMessage.java) |  \n| set dual call state | [`setDualCallState(DualCallState state)`](./examples/src/main/java/fr/bmartel/bboxapi/voicemail/examples/action/SetDualCallState.java) |  \n| set incognito mode | [`setIncognitoMode(IncognitoState state)`](./examples/src/main/java/fr/bmartel/bboxapi/voicemail/examples/action/SetIncognitoState.java) | \n| set SMS notification | [`setVoiceMailSMS(NotifState voiceMail, NotifState missedCall, String number)`](./examples/src/main/java/fr/bmartel/bboxapi/voicemail/examples/action/SetSmsNotification.java) |\n| set voiceMail state | [`setVoiceMailState(VoiceMailState state, int ringNumber)`](./examples/src/main/java/fr/bmartel/bboxapi/voicemail/examples/action/SetVoiceMailState.java) |\n| set welcome message state | [`setWelcomeMessageState(WelcomeMessageState state)`](./examples/src/main/java/fr/bmartel/bboxapi/voicemail/examples/action/SetWelcomeMessageState.java) | \n\n**Note**: If you need to list voicemail, read voicemail, get voicemail URL, forward call, use [official Bbox Router API](https://api.bbox.fr/doc/apirouter/index.html) with [Java/Android client for Bbox Router API](https://github.com/bertrandmartel/bboxapi-router)\n\nAll APIs need authentication via : \n\n```java\nVoiceMailApi api = new VoiceMailApi();\n\napi.login(\"username@bbox.fr\", \"password\");\n```\n\nThis will only work with your `@bbox` account (no such service for mobile)\n\n## Include into your project\n\n* with Gradle, from JCenter or MavenCentral :\n\n```java\ncompile 'fr.bmartel:bboxapi-voicemail:1.0.0'\n```\n\n## Usage\n\n### Get welcome message\n\nThis will store the welcome message to a local file. The following will store the welcome message with id 1 under `/home/user/message.wav` : \n\n```java\napi.getWelcomeMessage(1, \"/home/user/message.wav\");\n```\n\n### Upload welcome message\n\nThe following will upload `/home/user/message2.mp3` as the welcome message with id 2 and select the welcome message with id 2 :\n\n```java\napi.uploadWelcomeMessage(\"/home/user/message2.mp3\", 2, 2);\n```\n\n### Set dual call state\n\n```java\napi.setDualCallState(DualCallState.ENABLE);\n```\n\n### Set incognito mode\n\n```java\napi.setIncognitoMode(IncognitoState.DISABLE);\n```\n\n### Set SMS notification\n\nenable SMS notification to specified phone number on new voicemail and on missed call : \n```java\napi.setVoiceMailSMS(NotificationState.ENABLE, NotificationState.ENABLE, \"0123456789\");\n```\n\n### Set voicemail state\n\nenable/disable voicemail and set the ring number (default 5)\n\n```java\napi.setVoiceMailState(VoiceMailState.ENABLE, 5);\n```\n\n### Set welcome message state\n\nenable/disable welcome message : \n\n```java\napi.setWelcomeMessageState(WelcomeMessageState.ENABLE);\n```\n\n## Other APIs\n\nFor reference, the following API are implemented : \n\n| description     | api          |       \n|--------------|---------|\n| get voicemail list | [`getVoiceMailList()`](./examples/src/main/java/fr/bmartel/bboxapi/voicemail/examples/request/GetVoiceMailList.java) |\n| delete voicemail | [`deleteVoiceMail(int id)`](./examples/src/main/java/fr/bmartel/bboxapi/voicemail/examples/action/DeleteVoiceMail.java) |   \n| get user info | [`getCustomerInfo()`](./examples/src/main/java/fr/bmartel/bboxapi/voicemail/examples/request/GetUserInfo.java) | \n| forward call | [`setCallForwarding(CallForwardType type, String phoneNumber)`](./examples/src/main/java/fr/bmartel/bboxapi/voicemail/examples/action/SetForwardCall.java) | \n\n**Don't use these API above**, use [official Bbox Router API](https://api.bbox.fr/doc/apirouter/index.html) instead with [Java/Android client for Bbox Router API](https://github.com/bertrandmartel/bboxapi-router)\n\n### Get voicemail list \n\n```java\nVoiceMailResponse voiceMailResponse = api.getVoiceMailList();\n\nif (voiceMailResponse.getStatus() == HttpStatus.OK) {\n\n    List\u003cVoiceMail\u003e voiceMailList = voiceMailResponse.getVoiceMailList();\n}\n```\n\n### Delete voicemail\n\n```java\napi.deleteVoiceMail(\"1234567\");\n```\n\n### Get user info\n\n```java\napi.getCustomerInfo();\n```\n\n### Forward call\n\ndisable forward call\n\n```java\napi.setCallForwarding(CallForwardType.DISABLE, \"\");\n```\n\nforward all call to voicemail : \n\n```java\napi.setCallForwarding(CallForwardType.ALL_TO_VOICEMAIL, \"\");\n```\n\nforward all call to phone number : \n\n```java\napi.setCallForwarding(CallForwardType.ALL_TO_NUMBER, \"0123456789\");\n```\n\nforward unanswered call to phone number : \n\n```java\napi.setCallForwarding(CallForwardType.UNANSWERED_CALL_TO_NUMBER, \"0123456789\");\n```\n\nforward call to phone number when line is occupied : \n\n```java\napi.setCallForwarding(CallForwardType.LINE_OCCUPIED_TO_NUMBER, \"0123456789\");\n```\n\nforward call to pĥone number when line is unavailable : \n\n```java\napi.setCallForwarding(CallForwardType.LINE_UNAVAILABLE_TO_NUMBER, \"0123456789\");\n```\n\n## Android integration\n\n* add `bboxapi-voicemail` \u0026 `httpcomponents` lib depedency to `build.gradle` : \n\n```java\ncompile 'org.apache.httpcomponents:httpclient-android:4.3.5.1'\ncompile 'fr.bmartel:bboxapi-voicemail:1.0.0'\n```\n\n* add Internet permission to manifest :\n\n```java\n\u003cuses-permission android:name=\"android.permission.INTERNET\" /\u003e\n```\n\n* proguard config (keep model \u0026 response packages) :\n\n```\n-keep class fr.bmartel.bboxapi.voicemail.model.** { *; }\n-keep class fr.bmartel.bboxapi.voicemail.response.** { *; }\n```\n\n## External Library\n\n* [Apache HttpComponents](https://hc.apache.org)\n* [JSoup](https://jsoup.org/)\n\n## License\n\nThe MIT License (MIT) Copyright (c) 2017 Bertrand Martel\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbertrandmartel%2Fbboxapi-voicemail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbertrandmartel%2Fbboxapi-voicemail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbertrandmartel%2Fbboxapi-voicemail/lists"}