Getting Started

This guide covers everything a user needs: install the Android app, connect it (Setup QR), and send messages from the pChat sender app or from your code (any language).

Overview (3 Parts)

1
Relay Server
Hosted relay + HTTPS API + queue + auth.
2
Android Phone
Connects to the relay and delivers messages via the selected channel.
3
Senders
Your code (any language) or the included web sender app (pChat).
Keep your credentials private. If you suspect compromise, rotate/revoke keys and reconfigure clients/phones.

1) Install The Android App

Install from Google Play (recommended) or download the APK from the site Download section.

If you install via APK, Android may ask you to allow “install unknown apps” for your browser/files app.

Use this exact flow when copy/install is blocked:

  1. Download APK on phone from the QR/link.
  2. If it won't open/install:
    • Settings -> Apps -> (Chrome or Files) -> Install unknown apps -> Allow
    • Play Store -> Profile -> Play Protect -> Gear -> turn off "Scan apps with Play Protect" (temporary)
  3. Install APK again.
  4. Re-enable Play Protect scan: Play Store -> Profile -> Play Protect -> Gear -> turn on "Scan apps with Play Protect".

If file copy from PC is blocked, use ADB (no manual copy needed):

adb devices
adb install -r phone-agent.apk

If you get INSTALL_FAILED_UPDATE_INCOMPATIBLE:

adb uninstall com.agentphone.app
adb install phone-agent.apk

If adb devices shows nothing:

  • Enable Developer options + USB debugging on phone
  • Accept the RSA prompt on phone
  • Re-run adb devices

2) Connect The Phone (Setup QR)

Open the Setup QR page on desktop, generate a QR, scan it with the phone, and approve “Open in ChatPhoneApp”.

A
Hosted (Setup Code)
If you purchased access, enter the Setup Code and click Generate.

Open Setup QR

Install the Android app before scanning. The QR config does not install apps.

3) Send Messages

You can send from the pChat web sender app (no code) or from your own code (HTTPS).

pChat web app: Open pChat

HTTPS API (any language) + examples:

HTTP API Examples

Common Workflows

Typical ways people use ChatPhoneApp Server:

  • System alerts: notify via SMS/WhatsApp/Telegram when a service is down or a job fails.
  • Trading/monitoring: send an alert when a condition triggers (PnL, drawdown, fill, latency).
  • Daily summaries: email a daily report and send a short SMS/Telegram “highlights” message.
  • Web sender app: use pChat to send messages manually across channels from a browser.
  • AI assistant: ask in natural language and let your backend send after validation/confirmation.
If you want AI: start here → AI Assistant Integration

Troubleshooting

Quick checks:

# Relay health
curl -sS http://127.0.0.1:5110/health

# If you can't reach the relay from the phone:
# use the hosted relay URL shown on Setup QR / portal.

# Find what's using a port
sudo lsof -i :5110
sudo lsof -i :8001
If a request returns 401 Unauthorized, it usually means the CLIENT_API_KEY is missing/incorrect.

Quick Links

HTTP API (Send + Status) Examples (Python, C++, ...) pChat App + PCHAT Endpoints AI Assistant Integration Setup QR Page
Hosted mode: use the relay URL + credentials shown on Setup QR / portal, then use the same API endpoints in HTTPS API.