Accessibility Service Disclosure
Last updated:
1. Purpose
Agently uses the Android Accessibility Service API solely to automate USSD (Unstructured Supplementary Service Data) menu navigation for mobile money agent transactions. This is the core functionality of the app. It enables agents to complete cash-in, cash-out, balance check, and airtime transfer transactions faster by automatically navigating the multi-step USSD menus provided by network operators (MTN MoMo, Telecel Cash).
2. What the Accessibility Service Accesses
The Accessibility Service interacts exclusively with USSD dialog windows from the following phone/dialer system applications:
- com.android.phone: Android default phone app
- com.samsung.android.phone: Samsung phone app
- com.google.android.dialer: Google Dialer
- com.android.server.telecom: Android Telecom service
- com.mediatek.phone: MediaTek phone app
- com.qualcomm.qti.telephonyservice: Qualcomm telephony service
The service reads the text content displayed in USSD dialog boxes to determine the current menu state, and then automatically selects menu options or enters pre-filled transaction details (phone number, amount) as specified by the agent before the transaction started.
3. How the Automation Works
The automation follows a deterministic, rule-based script:
- Before a USSD session begins, the agent enters the customer's phone number, amount, and selects the transaction type.
- Agently builds a static queue of inputs (e.g., menu option "1", phone number, amount).
- When a USSD dialog appears, the service reads the dialog text and sends the next queued input.
- This repeats for each menu screen until the PIN entry screen is reached.
- Automation always stops at the PIN entry screen. The agent must manually enter their mobile money PIN directly into the network operator's USSD dialog.
4. What the Accessibility Service Does NOT Access
- Content from any app other than the phone/dialer USSD dialog packages listed above
- Keystrokes, passwords, PINs, or any text input by the user
- Screen content, notifications, or UI elements from other applications
- Contacts, messages, call logs, or any other personal data on the device
- Browser content, emails, or social media
5. Data Collection Through the Accessibility Service
No personal or sensitive data is collected, stored, transmitted, or shared through the Accessibility Service.
- All USSD dialog text processing happens locally on the device in real-time.
- USSD dialog content is not logged, recorded, or sent to any server.
- No data obtained through the Accessibility Service is shared with any third party.
- Transaction success/failure messages detected by the service are used only to update the local transaction history on the device.
6. PIN Security
Agently never accesses, stores, or transmits your mobile money PIN. The automation is specifically designed to detect PIN entry prompts (containing keywords such as "Enter PIN", "Enter MM PIN", "Enter your MoMo PIN") and immediately stop all automation. The agent always enters their PIN manually, directly into the network operator's native USSD dialog — exactly as they would without using Agently.
7. User Consent
Before the Accessibility Service can be enabled, Agently displays a prominent in-app disclosure during onboarding that clearly explains:
- What data the Accessibility Service accesses
- How the data is used
- What the service does NOT access
- That no data is shared with third parties
The user must provide affirmative consent (by ticking a checkbox) before being directed to the Android Accessibility Settings to enable the service. Users who do not consent can continue using the app with limited functionality (transaction history, community features, fraud database) but without USSD automation.
8. Disabling the Service
Users can disable the Agently Accessibility Service at any time through Android Settings → Accessibility → Agently. Disabling the service will stop all USSD automation but the app will continue to function for non-automation features.
9. Related Policies
- Privacy Policy: Full details on data collection and handling
- What We Don't Collect: Concise summary of data Agently never accesses (PINs, contacts, location, SMS, call logs, advertising IDs)
- Terms of Service: Usage terms and conditions
10. Contact
For questions about our use of the Accessibility Service:
Email: privacy@agentlygh.com