Harmonia
Get started

Twilio & Telnyx

Wire your own SMS/voice carrier to Harmonia.

Harmonia routes SMS and voice traffic through your own Twilio or Telnyx account. We don't middleman your sender reputation, your numbers, or your billing.

Twilio

  1. Get your Account SID and Auth Token from console.twilio.com.
  2. In Harmonia, open Settings → Integrations → Twilio.
  3. Paste both. Save.
  4. Pick a Messaging Service (or a single phone number) as your default sender.

Harmonia stores credentials encrypted at rest with AES-256-GCM. The master key is rotation-safe (see HARMONIA_INTEGRATION_SECRET in self-host docs).

Telnyx

The recommended carrier for MCA brokers — Telnyx underwriting tolerates the vertical that Twilio increasingly flags.

  1. Generate a v2 API key in the Telnyx Portal.
  2. In Harmonia, open Settings → Integrations → Telnyx.
  3. Paste the key. Pick a Messaging Profile.
  4. Configure inbound webhooks per the on-screen instructions — Harmonia provides the URL.

Numbers

Numbers stay yours. Buy them in Twilio or Telnyx — Harmonia just sends through them. Number transfers between carriers are independent of Harmonia.

Outbound kill switch

Every tenant has a global outbound switch at Settings → Comms → Outbound. While it's off, no email/SMS/voice tool — UI, workflow, MCP, or API — can deliver. Useful during onboarding while you're still importing data and don't want a stray automation paging contacts.

Inbound

Inbound SMS lands in the Unified Inbox, threaded to whichever contact owns the source number. Inbound voice fires the webhook config on your number — Harmonia ships a TwiML/TeXML stub that records, logs, and either rings a rep or routes through your IVR tree.