Een Zadarma-nummer importeren in Famulor: automatisch of via de PBX?

Sinds 7 oktober 2026 kun je een actief Zadarma-nummer koppelen via de carrier-importworkflow van Famulor. De belangrijkste stap vindt plaats vóór de import: bepaal of het nummer direct naar een AI-assistent moet worden gerouteerd, of dat je bestaande Zadarma PBX de gespreksstroom moet blijven beheren. Automatische import en handmatige PBX-routering lossen verschillende problemen op.

Belangrijkste punten

• Automatische import is ontworpen voor een actief direct SIP-nummer dat niet gekoppeld is aan de Zadarma PBX.
• Elk geïmporteerd nummer gebruikt zijn eigen verbinding en toegewezen SIP-login.
• Als de bestaande PBX schema's, wachtrijen of toestellen moet blijven beheren, gebruik dan het gedocumenteerde handmatige PBX-pad.
• Een API-key en API-secret zijn geen SIP-inloggegevens.
• Test inkomende en uitgaande gesprekken, tweeweg-audio, nummerweergave en doorverbinden afzonderlijk.

Wat de nieuwe Zadarma-import afhandelt

De nieuwe workflow koppelt je Zadarma-account, laadt in aanmerking komende nummers en maakt de SIP-routeringsconfiguratie aan voor het geselecteerde nummer. Volgens de Famulor changelog van 7 oktober 2026 selecteer je na de import een SIP-regio en wijs je een assistent toe. Dezelfde carrier-workflows zijn ook beschikbaar via de Public API, MCP en Famulor CLI.

Dit is beperkter dan een volledige PBX-migratie. De import configureert geen Zadarma PBX-doorschakeling of sms. Bovendien gebruikt het één verbinding per actief nummer, dus een extra nummer vereist een nieuwe verbinding.

Deze focus onderscheidt deze handleiding van de bredere introductie tot BYOC met Famulor. De vraag hier is niet of je een bestaand nummer kunt gebruiken, maar welk Zadarma-routeringspad past bij de huidige gespreksstroom.

Automatische import of handmatige verbinding?

Kies het pad op basis van welk systeem de gespreksstroom moet aansturen. De Famulor Zadarma-handleiding beschrijft drie benaderingen.

Gebruik geen automatische import voor een nummer waarvan het bestaande PBX-scenario ongewijzigd moet blijven. De import vervangt de directe SIP-toewijzing. Voor gemengde menselijke en AI-stromen is een handmatig PBX-toestel vaak de meer geschikte gedocumenteerde architectuur.

Vereisten vóór de import

Controleer eerst de telefoniezijde in Zadarma. Dit voorkomt dat een geldige API-koppeling later faalt omdat het geselecteerde nummer of de SIP-login niet bij de workflow past.

1. Actief virtueel nummer: Het nummer moet actief zijn en de testmodus moet zijn uitgeschakeld.
2. Directe SIP-login: Voor automatische import mag de SIP-login niet gekoppeld zijn aan de virtuele PBX.
3. Beschikbare login-slot: Houd één SIP-login-slot vrij. Zadarma vereist mogelijk een initiële opwaardering en een gekoppeld nummer voordat een nieuwe login wordt toegestaan.
4. Uitgaand saldo en rechten: Voor uitgaande tests zijn saldo en toestemming voor de bestemming vereist.
5. API-toegang: Open in Zadarma Instellingen → Integraties en API → Keys en API en kopieer de key en secret afzonderlijk.

De officiële Zadarma API-documentatie bevestigt dat API-verzoeken worden geautoriseerd met een gebruikers-key en een handtekening. Behandel beide waarden als inloggegevens. Ze horen niet thuis in een systeem-prompt van een assistent, een kennisbank of een testrapport.

API-toegang is geen SIP-toegang

Dit onderscheid voorkomt een veelvoorkomende klasse configuratiefouten:

• API-key en API-secret laten de import het Zadarma-account inspecteren, beschikbare nummers weergeven en de verbinding aanmaken.
• SIP-login en SIP-wachtwoord authenticeren uitgaande gesprekken in een handmatig direct-SIP- of PBX-pad.
• PBX-toestel-login gebruikt de volledige Zadarma-login in plaats van alleen het korte toestelnummer.

Sla deze waarden alleen op in de daarvoor bestemde verbindingsvelden, nooit in gespreksinstructies.

Het Zadarma-nummer automatisch importeren

Het automatische pad is geschikt voor een nummer dat direct naar Famulor moet routeren.

1. Open de verbindingsworkflow

Ga in Famulor naar Instellingen → Telefoonnummers → Nummer toevoegen → Importeren van je provider → Zadarma. Geef de verbinding een duidelijke naam, zeker wanneer een bureau nummers beheert voor meerdere klanten.

2. Voeg inloggegevens toe en selecteer een regio

Voer de API-key en secret in de daarvoor bestemde velden in. Selecteer vervolgens de SIP-regio. Die regio bepaalt het inkomende signaleringseindpunt, dus wijzig dit later niet zonder beide gespreksrichtingen opnieuw te testen.

3. Laad de nummerlijst

Laad de nummers uit het Zadarma-account. De interface identificeert of een nummer actief is, al is geïmporteerd of elders wordt gerouteerd. Selecteer één in aanmerking komend actief nummer.

4. Voltooi de import en wijs een assistent toe

Importeer één nummer per verbinding. De workflow maakt een toegewezen SIP-login aan en stelt de vaste uitgaande nummerweergave in voor die verbinding. Wijs de beoogde assistent toe nadat de import is voltooid.

5. Test vóór productiegebruik

Voer ten minste één inkomende en één uitgaande testoproep uit naar een bestemming die je beheert. Stop niet zodra je de kiestoon hoort. Bevestig de tweeweg-audio, de getoonde nummerweergave, het historie-record en elk doorverbindpad dat de assistent naar verwachting zal gebruiken.

Praktijkvoorbeeld: vastgoedbeheer met een bestaande centrale

Een vastgoedbeheerder gebruikt een bekend Zadarma-hoofdnummer. Tijdens kantooruren verdeelt een PBX-wachtrij gesprekken onder het team. Buiten kantooruren moet een AI-assistent onderhoudsproblemen opvangen, terugbelgegevens structureren en echte noodgevallen doorsturen naar de storingsdienst.

Automatische import van het hoofdnummer is hier niet de eerste keuze, omdat dit de directe SIP-bestemming vervangt. De gedocumenteerde PBX-aanpak behoudt de bestaande stroom:

1. Het hoofdnummer blijft toegewezen aan het bestaande Zadarma PBX-scenario.
2. Een PBX-toestel wordt de route naar de AI-assistent.
3. De PBX schakelt door naar de externe Famulor SIP-URI onder de gekozen schema- of wachtrijvoorwaarde.
4. De Famulor-assistent ontvangt alleen de bedoelde gesprekken.
5. Een afzonderlijke doorverbindtest valideert de overdracht naar de storingsdienst.

Zadarma documenteert External Server SIP-URI-routering voor zowel directe nummers als PBX-toestellen in zijn officiële routeringsinstructies. Neem altijd de exacte Famulor-bestemming en de huidige signaleringsadressen uit de Famulor-interface of de actuele handleiding van de provider.

Voor een bredere walkthrough over 3CX, STARFACE en Asterisk, gebruik de handleiding voor het verbinden van een AI-voice-agent met een bestaande PBX. Dit artikel blijft bewust specifiek voor Zadarma.

Productietestmatrix

Eén geslaagd gesprek is geen volledige telefonietest. Gebruik een korte matrix die elk pad isoleert.

Als een test faalt, begin dan met Problemen oplossen bij de carrier-verbinding en bevestig dat je het beoogde SIP-pad hebt gekozen. Volgens de Famulor-providerhandleiding bewijst een toestel dat als offline wordt weergegeven op zichzelf niet dat externe doorschakeling is mislukt.

Beperkingen, privacy en telefonie-opmerkingen

Zadarma-import automatiseert routering, niet de volledige telefoniestrategie.

• PBX blijft een afzonderlijke architectuurkeuze: Automatische import en een PBX-toestel zijn alternatieve routes. De import herschept geen bestaand PBX-scenario.
• Sms is niet inbegrepen: De huidige Zadarma-import configureert geen Zadarma-sms.
• Meerdere nummers vereisen meerdere verbindingen: Plan naamgeving, eigenaarschap en testen per nummer.
• Nummerweergave is niet willekeurig: Gebruik het publieke nummer dat aan de verbinding is gekoppeld en bevestig de presentatie met een gecontroleerde testbestemming.
• Opname en toestemming worden afzonderlijk geconfigureerd: Schakel opname pas in na controle van de juridische basis en assistent-instellingen voor het beoogde gebruik. De Famulor-handleiding voor toestemming en gesprekskwaliteit beschrijft de relevante controles.
• Productcontroles zijn geen juridisch advies: De Documentatie over toestemming en compliance stelt dat jurisdictie, doel van outreach en communicatiekanaal nog steeds een afzonderlijke juridische beoordeling vereisen.

Documenteer wie de carrier-verbinding bezit, welk nummer het beïnvloedt en welke routering er vóór de import bestond. Dat dossier maakt een latere terugdraaiing makkelijker te begrijpen.

Plan terugdraaiing voordat je het nodig hebt

Verwijder onverwacht geen productienummer tijdens live-activiteiten. Bepaal waar gesprekken daarna naartoe moeten en reserveer een gecontroleerd testvenster.

De huidige changelog vermeldt dat het verwijderen van een automatisch geïmporteerd Zadarma-nummer de vorige directe SIP-bestemming herstelt, terwijl latere routeringswijzigingen in Zadarma behouden blijven. Bel desondanks het herstelde pad vanaf een externe telefoon. Accountstatus, PBX-regels of carrier-instellingen kunnen onafhankelijk van Famulor zijn gewijzigd.

Conclusie

De nieuwe Zadarma-import vermindert handmatig SIP-werk voor een direct, toegewezen nummer. De werkelijke waarde hangt af van de routeringsbeslissing die als eerste wordt genomen: automatische import voor directe toewijzing, handmatige directe SIP voor door de operator beheerde routering, of een PBX-toestel wanneer een bestaande menselijke gespreksstroom de controle moet behouden.

Controleer inloggegevens, nummerstatus en SIP-toewijzing vóór de import. Test daarna beide gespreksrichtingen en elk doorverbindpad. Dat levert een traceerbare overgang op in plaats van een risicovolle cutover in één stap.

Veelgestelde vragen

Kan ik automatisch een nummer importeren dat gekoppeld is aan een Zadarma PBX?

Automatische import is gedocumenteerd voor een actief direct SIP-nummer waarvan de SIP-login niet gekoppeld is aan de PBX. Gebruik het handmatige PBX-pad wanneer het bestaande PBX-scenario behouden moet blijven.

Kan één verbinding meerdere Zadarma-nummers importeren?

Nee. De huidige workflow importeert één actief nummer per verbinding. Maak een nieuwe verbinding aan voor elk extra nummer.

Configureert de import ook sms?

Nee. De huidige Zadarma-import configureert gespreksroutering, geen Zadarma PBX-doorschakeling of sms.

Is één geslaagde inkomende test voldoende?

Nee. Test uitgaande gesprekken, nummerweergave en doorverbinden afzonderlijk, omdat deze andere inloggegevens en routeringspaden gebruiken.

Wat gebeurt er als ik het geïmporteerde nummer verwijder?

Volgens de changelog wordt de vorige directe SIP-bestemming hersteld. Test die herstelde route daarna met een extern gesprek.