Ga naar hoofdinhoud
Audact
Bekijk het aanbod
Alle handleidingen
Op deze pagina

Eigen nummers meenemen

Integreer telefoonnummers met Audact via door Audact ingerichte nummers (via Telnyx) of uw eigen SIP-trunk, met stapsgewijze installatie voor Twilio, Telnyx en generieke SIP-aanbieders.

Dit document beschrijft hoe u telefoonnummers integreert met het gespreksverwerkingsplatform van Audact via twee afzonderlijke routes: door Audact ingerichte nummers (beheerd via Telnyx) en eigen trunks (BYO, beheerd via uw eigen telefonaanbieder).

Twee nummertypen

Audact ondersteunt twee fundamentele manieren om telefoonnummers voor inkomende gespreksroutering aan te bieden:

Type 1: Door Audact ingerichte nummers (Telnyx)

Audact beheert de volledige nummerlevenscyclus via zijn Telnyx-carrierrelatie.

Aanschaf: U vraagt nummers aan via de KYC-documentindiening en de nummerbestelstroom gedocumenteerd in Nummerinrichting en KYC. Audact versleutelt uw nalevingsdocumenten, dient ze in bij Telnyx ter goedkeuring en zodra goedgekeurd, kunt u DID's bestellen in elke land/type-combinatie die door die goedkeuring is gedekt.

Levenscyclus: Nummers worden opgeslagen in de pool van Audact, toegewezen aan agenten via de platform-API en automatisch gefactureerd via de Telnyx-account van Audact. Het platform configureert de Telnyx SIP-trunkverbinding namens u — u hoeft nooit verbindingsparameters op te geven.

Beëindiging: Er bestaan twee bewerkingen:

  • Vrijgeven: Wis de agenttoewijzing en retourneer het nummer aan de pool (DELETE /v1/numbers/{id}/release). De DID blijft eigendom van Audact en is beschikbaar voor toekomstige hertoewijzing.
  • Verwijderen: Verwijder het nummer definitief en geef de DID terug aan de voorraad van Telnyx (DELETE /v1/numbers/{id}). Dit is onomkeerbaar; het nummer verdwijnt van het platform en uit de pool van de telecomoperator.

Verbinding: Automatisch. U wijst uw Telnyx-account naar de SIP-ingresshost die in uw dashboard wordt weergegeven (opgehaald via GET /v1/byo/config), en Audact regelt de rest.

Type 2: Eigen trunk (BYO)

U beheert de nummerverwerving en de relatie met de telefonaanbieder; Audact accepteert inkomende gesprekken die via uw SIP-trunk worden gerouteerd.

Aanschaf: Nummers worden direct gekocht bij uw telefonaanbieder (Twilio, Telnyx of een andere SIP-aanbieder). U beheert de facturering, de carrierrelatie en de nummerpool.

Levenscyclus: U bent eigenaar van de nummers en kunt deze naar eigen inzicht bij uw aanbieder hertoewijzen of vrijgeven. Audact richt deze DID's niet in, factureert er niet voor en beheert ze niet — alleen inkomende gesprekken worden erop gerouteerd.

Beëindiging: U geeft nummers vrij bij uw telecomoperator. Audact stopt eenvoudigweg met het routeren van gesprekken naar dat nummer.

Verbinding: U configureert de SIP-trunk-originatie-URI zodat deze verwijst naar de SIP-ingress van Audact (weergegeven in uw dashboard via GET /v1/byo/config). Audact valideert inkomende gesprekken aan de hand van uw pool van geconfigureerde BYO-nummers en routeert ze naar de juiste agenten.

Installatie van Type 1: Door Audact ingerichte nummers

Zie Nummerinrichting en KYC voor de volledige levenscyclus. Samengevat:

  1. Upload KYC-documenten via POST /v1/kyc/documents
  2. Maak een documentenset aan via POST /v1/kyc/document-sets (Telnyx keurt asynchroon goed)
  3. Zodra goedgekeurd, plaatst u een nummerbelling via POST /v1/numbers/orders
  4. Wijs nummers toe aan agenten via POST /v1/numbers/{id}/assign
  5. Audact configureert de Telnyx SIP-trunk automatisch

Voor Type 1-nummers is geen handmatige SIP-trunkconfiguratie vereist.

Installatie van Type 2: Eigen trunks

Uw SIP-trunk initieert gesprekken naar de SIP-ingress van Audact. De volgende secties documenteren drie veelgebruikte aanbiedersinstallaties en een generiek SIP-sjabloon.

Uw SIP-ingressconfiguratie opvragen

Haal vóór het configureren van een BYO-trunk de SIP-ingressinstellingen van uw huurder op:

bash

curl -X GET https://api.audact.ai/v1/byo/config \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Respons:

json

{
  "sip_ingress_host": "sip.us.audact.ai",
  "sip_ingress_port": 5060,
  "allowed_source_cidrs": ["203.0.113.0/24"],
  "healthy_numbers": ["+14155551234", "+14155551235"],
  "failed_numbers": []
}

Gebruik de sip_ingress_host en sip_ingress_port hieronder.

Een Twilio-trunk verbinden

Het SIP Trunking-product van Twilio maakt het mogelijk gesprekken te initiëren naar een externe SIP-server.

1. Een Twilio SIP-trunk aanmaken

  1. Log in op de Twilio Console → Elastic SIP Trunks
  2. Klik op + om een nieuwe trunk aan te maken
  3. Kies een beschrijvende naam (bijv. audact-sip-trunk)
  4. Klik op Create

2. De originatie-URI configureren

In de trunk-instellingen, onder Originating SIP Address:

  1. Klik op + om een originatie-URI toe te voegen
  2. Voer in: sip:${SIP_INGRESS_HOST}:${SIP_INGRESS_PORT} (bijv. sip:sip.us.audact.ai:5060)
  3. Stel Priority in op 10 (lagere waarde = hogere prioriteit)
  4. Stel Weight in op 100
  5. Laat Enabled aangevinkt
  6. Klik op Add

3. Een inloggegevenslijst aanmaken (indien vereist)

Als u SIP-authenticatiegegevens naar Audact moet sturen:

  1. Scrol in de trunk naar Credential List
  2. Klik op + om inloggegevens toe te voegen
  3. Voer de naam van uw inloggegevenslijst in (bijv. audact-credentials)
  4. Selecteer Credential Type: SIP Credentials
  5. Voer de gebruikersnaam en het wachtwoord in (coördineer met Audact-ondersteuning)
  6. Klik op Create
  7. Wijs de inloggegevenslijst toe aan de trunk

Opmerking: De meeste Twilio-trunks gebruiken IP-authenticatie (IP-allowlijst) in plaats van inloggegevens. Verifieer dit met uw installatie.

4. Telefoonnummerroutering configureren

Voor elk telefoonnummer dat u via deze trunk wilt routeren:

  1. Ga in de Twilio Console naar Phone Numbers → Active Numbers
  2. Selecteer het nummer
  3. Stel onder Voice & Fax in:
    • Configure With: SIP Trunk
    • SIP Trunk: selecteer uw zojuist aangemaakte audact-sip-trunk
  4. Opslaan

5. Audact-IP's op de allowlijst plaatsen (optioneel)

Als uw Twilio-trunk IP-authenticatie gebruikt:

  1. Zoek in de trunk-instellingen Originating SIP Address
  2. Noteer eventuele IP-beperkingen op de originatie-URI
  3. Vraag de lijst met uitgaande SIP-server-IP's op bij Audact-ondersteuning
  4. Voeg ze toe aan de IP-allowlijst van uw Twilio-trunk

Een Telnyx-trunk verbinden

Het SIP Trunking-product van Telnyx is vergelijkbaar met Twilio. Als u al Telnyx-nummers heeft maar BYO-trunking wilt gebruiken (in plaats van door Audact ingerichte nummers), volg dan deze handleiding.

1. Een Telnyx SIP-verbinding aanmaken

  1. Log in op de Telnyx Portal → Connections → SIP Connections
  2. Klik op Create SIP Connection
  3. Kies een verbindingsnaam (bijv. audact-sip-connection)
  4. Voeg onder Outbound een Originating SIP Address toe:
    • Voer in: sip:${SIP_INGRESS_HOST}:${SIP_INGRESS_PORT} (bijv. sip:sip.us.audact.ai:5060)
  5. Klik op Create

2. Authenticatie configureren

Optie A: IP-authenticatie

  1. Zoek in uw Telnyx-verbindingsinstellingen IP Authentication
  2. Voeg de SIP-server-IP's van Audact toe aan de allowlijst
  3. Vraag de exacte IP-bereiken op bij Audact-ondersteuning

Optie B: SIP-inloggegevens

  1. Selecteer onder Authentication in uw verbindingsinstellingen Username & Password
  2. Voer uw gebruikersnaam in (bijv. uw huurder-ID of API-sleutelidentificator)
  3. Stel een wachtwoord in
  4. Klik op Save
  5. Deel deze inloggegevens veilig met Audact

3. Telefoonnummers toewijzen

Wijs voor elk BYO-nummer het toe aan de SIP-verbinding:

  1. Ga naar Inventory → Phone Numbers
  2. Selecteer een nummer
  3. Stel onder Routing in:
    • Connection Type: SIP Connection
    • Connection: selecteer uw audact-sip-connection
  4. Voer de Sip Termination URI in: sip:${SIP_INGRESS_HOST}:${SIP_INGRESS_PORT}
  5. Opslaan

4. Facturering configureren

Zorg ervoor dat de facturering rechtstreeks via Telnyx is ingesteld — Audact factureert u niet voor BYO-nummers. Telnyx factureert u voor minuten, terminering en nummerhuur.

Een generieke SIP-trunk verbinden

Als uw aanbieder niet Twilio of Telnyx is, gebruik dan dit generieke SIP-originatiesjabloon.

Vereisten

  • Uw SIP-aanbieder staat uitgaande originatie naar elke externe SIP-server toe
  • U heeft uitgaande SIP-inloggegevens of IP-allowlijsttoegang
  • Uw aanbieder ondersteunt E.164-telefoonnummeropmaak in SIP INVITE-headers

Configuratiestappen

  1. Voeg Audact toe als originerende peer in het portal van uw aanbieder:

    • Peer-adres: ${SIP_INGRESS_HOST}:${SIP_INGRESS_PORT} (bijv. sip.us.audact.ai:5060)
    • Protocol: SIP (UDP of TCP, coördineer met Audact)
    • Poort: 5060 (standaard; bevestig met uw aanbieder en Audact)

  2. Authenticatie (kies één):

    Optie A: IP-authenticatie

    • Voeg het openbare IP-adres van uw SIP-server of -gateway toe aan de allowlijst van Audact
    • Vraag het IP-bereik van de SIP-server van Audact op bij de ondersteuning
    • Voeg de IP's van Audact toe aan de allowlijst van uw aanbieder

    Optie B: Digest-authenticatie (gebruikersnaam en wachtwoord)

    • Stel Gebruikersnaam in: uw API-sleutel, huurder-ID of door de aanbieder toegewezen inloggegevens
    • Stel Wachtwoord in: een veilig geheim
    • Zorg ervoor dat uw aanbieder inloggegevens verstuurt in de SIP INVITE of REGISTER
    • Deel inloggegevens met Audact-ondersteuning zodat we ze kunnen valideren

  3. Originatieregels configureren:

    • Routeer voor elk telefoonnummer inkomend verkeer naar de Audact-peer
    • Zorg ervoor dat de SIP INVITE het E.164-opgemaakte nummer bevat in de To-header (bijv. To: <sip:+14155551234@sip.us.audact.ai>)

  4. De verbinding testen:

    • Controleer of SIP-pakketten Audact bereiken door de gesprekslogboeken van uw aanbieder te bekijken
    • Controleer het Audact-dashboard om te zien of het gesprek aankomt (de gezondheidsstatus moet overgaan van unverified naar healthy)

Trunkgezondheidsstatussen

Zodra een BYO-trunk is geconfigureerd, volgt Audact de gezondheidsstatus ervan. Gebruik deze statussen om verbindingsproblemen te diagnosticeren.

Betekenis van gezondheidsstatus

StatusBetekenisOplossing
unverifiedEr zijn nog geen gesprekken ontvangen op deze trunk. Dit is de beginstatus wanneer u hem voor het eerst configureert.Voer een testgesprek via een van uw BYO-nummers. De status wordt bijgewerkt zodra Audact het eerste gesprek ontvangt.
healthyAudact heeft gesprekken via deze trunk ontvangen en gerouteerd.Geen actie vereist. Gesprekken worden normaal gerouteerd.
unreachableDe SIP-server reageert niet op SIP-registratie- of OPTIONS-verzoeken. Gesprekken kunnen worden geweigerd als de server echt offline is.Controleer of uw SIP-server actief is en de hostnaam wordt omgezet. Verifieer firewallregels die UDP 5060 (of TCP 5060) van uw aanbieder toestaan. Start uw SIP-server opnieuw indien nodig.
auth_failedAudact probeerde te authenticeren met de opgegeven inloggegevens, maar deze werden geweigerd. Dit treedt op als SIP Digest-authenticatie is ingeschakeld en de inloggegevens onjuist zijn.Verifieer dat de gebruikersnaam en het wachtwoord die u aan Audact heeft verstrekt overeenkomen met de inloggegevens die uw aanbieder verwacht. Als u IP-authenticatie gebruikt, zorg er dan voor dat uw IP-allowlijst correct is en dat de IP's van Audact zijn toegestaan.

Trunkstatus controleren

Gebruik het eindpunt GET /v1/byo/config om de trunkgezondheid te bekijken:

bash

curl -X GET https://api.audact.ai/v1/byo/config \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

De respons bevat health_status en last_check_timestamp voor elke trunk.

Probleemoplossingsworkflow

  1. DNS-omzetting verifiëren:

    bash

    nslookup ${SIP_INGRESS_HOST}

    Moet worden omgezet naar het IP-adres van uw SIP-server.

  2. SIP-verbinding testen vanaf uw server:

    bash

    # Using a SIP client or tool (e.g., sipvious, sipp)
sipp -sf register.xml ${SIP_INGRESS_HOST}:${SIP_INGRESS_PORT}

  3. Firewallregels controleren:

    • Zorg ervoor dat UDP/TCP 5060 open is tussen uw aanbieder en Audact
    • Bevestig dat het IP-bereik van Audact aan uw kant is toegestaan (als u IP-authenticatie gebruikt)

  4. SIP-logboeken bekijken:

    • Controleer de SIP-logboeken van uw aanbieder op INVITE-weigeringen of time-outs
    • Controleer de inkomende SIP-foutlogboeken van Audact in het dashboard

  5. Een gesprek testen:

    • Voer een testgesprek van een willekeurige telefoon naar een van uw BYO-nummers
    • Bekijk het gespreksverloop in het Audact-dashboard
    • Controleer de gezondheidsstatus: moet overgaan van unverified → healthy na het eerste succesvolle gesprek

Facturering en verantwoordelijkheden van BYO-trunk

AspectDoor Audact ingerichtBYO-trunk
NummerverwervingAudact (via Telnyx)U (uw aanbieder)
NummerfactureringAudact factureert uUw aanbieder factureert u
SIP-verbindingAudact configureert automatischU configureert en beheert
Inkomende gespreksrouteringAudact valideert en routeertAudact routeert; u beheert aanbiedersregels
Facturering gespreksbeëindigingAudact dekt dit (via Telnyx)Uw aanbieder rekent per minuut
NummervrijgaveU via DELETE /v1/numbers/{id}U via het portal van uw aanbieder

Nummertypen combineren

Een huurder kan gelijktijdig zowel door Audact ingerichte als BYO-trunks gebruiken. Bijvoorbeeld:

  • Wijs door Audact ingerichte nummers (+1415..., +44204...) toe aan bepaalde agenten
  • Routeer BYO-nummers (+1212... van Twilio, +61... van Telnyx-als-BYO) naar andere agenten
  • Audact routeert alle inkomende gesprekken op de juiste manier op basis van de DID

Er is geen speciale configuratie nodig — configureer eenvoudigweg beide typen parallel. Het eindpunt GET /v1/byo/config rapporteert zowel door Audact beheerde als BYO-trunks.

Bron bijgewerkt: 19 oktober 2026