Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.famulor.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Amazon Chime SDK Voice Connector Integration

Connect a Chime SDK Voice Connector to Famulor via SIP/TLS
If your phone numbers are provisioned through AWS, you can route them to Famulor by creating an Amazon Chime SDK Voice Connector and pointing its termination at your Famulor SIP address. Inbound calls land on the Voice Connector and are forwarded to Famulor; outbound calls from Famulor authenticate to the Voice Connector and break out to PSTN via AWS.
One-time setup: create the Voice Connector once. New AWS-provisioned DIDs can be assigned to it without re-doing the integration.

​
Prerequisites

  • An AWS account with Chime SDK enabled.
  • At least one phone number provisioned via Chime SDK in your target region (e.g. us-east-1, us-west-2).
  • Permissions for chime:*VoiceConnector* and chime:*PhoneNumber*.

​
Step 1: Create a Voice Connector

  1. Sign in to the Amazon Chime SDK console and select your region.
  2. Go to Voice Connectors → Create Voice Connector.
  3. Name: e.g. famulor-voice-connector.
  4. AWS Region: match the region where your numbers are provisioned.
  5. Encryption: Enabled (default — this enforces TLS for signaling and SRTP for media).
  6. Network Type: IPv4 Only.
  7. Create.

​
Step 2: Configure Termination (outbound from Famulor)

In the new Voice Connector, open the Termination tab:
  1. Termination status: Enabled.
  2. Allowed CIDRs: add Famulor’s current SIP egress CIDR ranges. Get these from Famulor support — LiveKit’s egress evolves over time.
  3. Calling Plan: select the country/region rates you’ve enabled in your AWS account.
  4. Default phone number: the DID you want Famulor to use as caller ID.
  5. Termination credentials: create a username/password pair. Save these — they go into Famulor in step 4.
Chime requires TLS + SRTP end-to-end when encryption is enabled. Make sure your Famulor project uses the TLS endpoint (sip:xxx.sip.livekit.cloud:5061;transport=tls) — if it falls back to UDP/5060, the trunk silently fails.

​
Step 3: Configure Origination (inbound to Famulor)

In the same Voice Connector, open the Origination tab:
  1. Origination status: Enabled.
  2. Add a route: 
    Host:      xxx.sip.livekit.cloud   (your Famulor SIP address)
Port:      5061
Protocol:  TLS
Priority:  1
Weight:    5
Find your Famulor SIP address: Famulor dashboard → Phone Numbers → Integrate SIP trunk → Our SIP address.

​
Step 4: Assign phone numbers to the Voice Connector

  1. Phone Numbers → Assignment → Assign to Voice Connector.
  2. Select your famulor-voice-connector.
  3. Move the desired DIDs into the Assigned column.

​
Step 5: Import the number into Famulor

  1. Open your Famulor dashboard and go to Phone Numbers → Integrate SIP trunk.
  2. Fill in: 
    Phone number:   Your Chime DID in E.164 (e.g. +1 415 555 0123)
Username:       The termination username from step 2
Password:       The termination password from step 2
  3. Outbound settings: 
    SIP address:            <voice-connector-id>.voiceconnector.chime.aws
Outbound number format: International (with +)
    Find the per-Voice-Connector hostname under the connector’s Details tab.
  4. Authorization type: Username and password.
  5. Country: the country of the assigned DID.

​
Step 6: Verify

  1. Assign the number to a Receive phone calls assistant. Call your Chime DID — the AI should answer.
  2. Create a Make phone calls assistant with the same number and trigger an outbound test call.

​
Common issues

Re-check that the DID is Assigned to the Voice Connector (not just provisioned in your account) and that Origination is Enabled with the correct Host/Port/TLS route.
Famulor’s egress IP isn’t in the Termination CIDR allowlist. Pull the latest egress range from Famulor support and update the Voice Connector’s Allowed CIDRs.
Chime requires SRTP when Encryption is Enabled. Either confirm your Famulor project advertises SRTP, or disable encryption on the Voice Connector (acceptable only for non-production tests — production should always use SRTP).
Your AWS account hasn’t enabled outbound calling to the destination country. Phone Numbers → Calling rules → request access for the relevant country.
Need help with setup? Our support team can supply the current Famulor SIP egress CIDR list for your Termination allowlist.
Related pages: SIP Integration and SIP Troubleshooting.