Join Discord Back to overview

Setup docs

Configure your Action URL.

Every hardware phone fires a single HTTP request to its "Action URL" when it rings. Point that request at Phonetix and each ring becomes a direct message.

Before you start: run /new in Discord first. It registers you on the FREE tier automatically and gives you a working URL for each brand below — copy those instead of typing your Discord ID by hand.

General setup.

The same three steps apply to every brand. Brand-specific menu paths are below.

  1. Get your URL. Run /new in Discord. Every account starts on FREE — you'll receive one URL per supported brand immediately.
  2. Find the Action URL field. On the phone's web admin interface, locate the setting for outbound event notifications — usually filed under Maintenance, Features, or Advanced.
  3. Paste and save. Assign your Phonetix URL to the phone's ring / incoming-call event and save. Apply or reboot if your firmware requires it.

By brand.

Menu labels vary by model and firmware version. If a name below doesn't match exactly, search your phone's admin guide for "Action URL" or "Event URL."

Grandstream

Caller ID source: $remote

Web UI → Maintenance → Action URL → assign the URL to the Ring event.

https://phonetix.cc/<your-discord-id>/grandstream?mac=$mac&caller=$remote

Yealink

Caller ID source: $callerID

Web UI → Features → Action URL / Action URL Limit → assign to Incoming Call.

https://phonetix.cc/<your-discord-id>/yealink?mac=$mac&caller=$callerID

Fanvil

Caller ID source: $call_id

Web UI → Features → Action URL → assign to the Ringing field.

https://phonetix.cc/<your-discord-id>/fanvil?mac=$mac&caller=$call_id

Snom

Caller ID source: $remote

Web UI → Advanced → Action URL Settings → action_incoming_call.

https://phonetix.cc/<your-discord-id>/snom?mac=$mac&caller=$remote

Poly / Polycom

Caller ID source: $remoteName$

Many Poly/VVX models only expose this through the provisioning config file rather than the web UI. Look for an Action URI parameter tied to the ringing feature.

https://phonetix.cc/<your-discord-id>/poly?mac=$mac&caller=$remoteName$

Want PRO?

PRO (5,000 calls/day) is $5/month and funds ongoing development. It isn't self-service.

  1. Contribute $5/month. Ask in the dev server for the current way to chip in.
  2. Ask someone with upgrade access to run /upgrade. Only members holding the designated role in the dev server can run this — it won't work anywhere else, and it won't work for other members.

Not receiving a DM?

Two things stop delivery, and both are on the Discord side, not the phone side:

  1. No shared server. The bot can only DM a Discord account that shares at least one server with it.
  2. DMs closed. Check Discord's Privacy Settings and confirm direct messages from server members are allowed.