↑↓ selectEnter openEsc close

    1. Elbuz
    2. Connecting a PBX

    How to connect Zadarma to Elbuz: CRM call log and voice AI on one number

    7 min readUpdated

    Elbuz turns the Zadarma cloud PBX into CRM telephony: one-click calls from the customer card, caller identification, and every call with its recording in the log and customer history. A voice AI employee can answer on the same number.

    When you need this:

    • A customer calls — the manager sees their name and recent orders.
    • Need to call back — “Call” in the card: Zadarma rings the manager, then the customer.
    • Missed call — “Pulse” gets a “Call back” task.
    • Managers busy or gone — an AI employee answers and takes the request.

    Where to start: copy the API key and secret in your Zadarma account.

    What the Zadarma integration does

    The integration uses two channels: through the , Elbuz places calls and reconciles the log every hour, and through notifications Zadarma itself tells Elbuz about every call. Voice AI is connected separately, but to the same number.

    • Caller card. An “Incoming call” pop-up shows the customer's name and recent orders; an unknown number is added with the “Create contact” button (incoming call card).
    • One-click call from the customer card. “Call” in the contact card or in the log — no need to dial the number (extensions).
    • Recording and summary in the customer's history. The call goes to the customer's feed, “Play recording” opens the recording, and AI analysis writes a summary and suggests the next step (AI call analysis).
    • A missed call becomes a task. A high-priority “Call back” appears in “Pulse” and closes by itself after a conversation with that number.
    • AI picks up. It gives the order status, answers questions about delivery and payment based on your articles, and takes down the request (Zadarma number to AI).
    • AI calls the customer itself. For example, a Flows process calls the customer after a new order to confirm it (outgoing AI calls).

    What you need from Zadarma

    • API key and secret — “Settings” → “Integrations and API”.
    • A PBX extension for each manager — “My PBX” → “Extensions”.
    • Call notifications, including the one about an incoming call starting on an extension — without it the incoming call card won't pop up (step three).
    • For AI — a separate extension for the AI SIP line and a number that AI can call from abroad (outgoing AI calls).

    The paths in the Zadarma account are taken from the operator's official documentation. If an item is named differently, use these pages or ask Zadarma support:

    How to connect Zadarma to the call log

    Three steps in order: keys, employee extensions, and call notifications. Without extensions the “Call” button doesn't work, and without notifications the log is filled only by the hourly reconciliation — with a delay of up to an hour.

    Step one: Zadarma keys

    1. Zadarma account → “Settings” → “Integrations and API”.
    2. The API keys are on the my.zadarma.com/api/ page: copy the key (Key) and the secret (Secret).

    Elbuz needs the secret twice: it signs requests to Zadarma, and Elbuz uses it to verify the signature of every notification from Zadarma.

    Open the Zadarma row in the “Telephony” group. The “Active” toggle is already on — leave it that way. Fields:

    Form fieldWhat to enter
    “API key”the key from your Zadarma account
    “Secret”the secret from the same pair
    “Line for outgoing calls”your Zadarma number that the customer will see; leave empty and Zadarma chooses one itself
    The “Telephony connection” card in the Zadarma form
    1Link to the guide
    2Status switch
    3API key field
    4Secret field
    5Outgoing line number field
    6Check connection button
    1. The “Where exactly — step by step in the guide for your operator” link leads to this page.
    2. The status switch — the integration is turned on.
    3. The API key field — the key from the provider account’s API settings.
    4. The secret field — the secret of the same pair; Elbuz uses it to verify the signature of notifications.
    5. The outgoing line number field — the number the customer will see; if empty, Zadarma picks one itself.
    6. The “Check connection” button — a read-only request to the provider; it changes nothing in the account.

    The form saves itself about a second after you make a change: at the bottom you see “Saving...”, then “Saved”. There is no “Save” button.

    Finally, click “Test connection”. Elbuz sends the operator a read-only request — it changes nothing in your account — and replies “Connected to the PBX. Employees in the PBX: ‹count›”. Zadarma doesn't return employee names, so the “PBX extensions without an Elbuz employee” line shows only numbers.

    Step two: extensions

    When a manager clicks “Call”, Zadarma first rings their extension and dials the customer only after they answer. The number comes from the “Internal phone” field in the employee card. The same number links calls in the log to the manager: the “Manager” column shows the name of the Elbuz employee who has this number.

    • You can see PBX extensions in your Zadarma account: “My PBX” → “Extensions”.
    • Enter the short number in the employee card (for example, 100), without the account prefix. The short number is how reconciliation tells an outgoing call from an incoming one.
    • Below the connection form there is an “Employee extensions” card — a “Manager” / “Extension” table for all active employees. Rows with a dash are those who don't have a number yet.

    Step three: how to turn on Zadarma notifications

    The form has a “PBX webhook address” card with the address and a “Copy” button. Then, in your Zadarma account (as described in the Zadarma API documentation):

    1. “Settings” → “Integrations and API”.
    2. In the notifications block, paste the address into the “Notifications about calls in PBX” field.
    3. Click “Enable”.

    When you save, Zadarma checks the address: it sends a test string to it and expects it back. Elbuz answers this check by itself, so the address is saved with no extra steps.

    Elbuz needs these notifications:

    • start and end of an incoming call;
    • start and end of an outgoing call;
    • call recording;
    • start of an incoming call on a PBX extension (NOTIFY_INTERNAL in the Zadarma documentation). Only this notification tells which extension the call is going to, and without it the incoming call card won't pop up.

    The Zadarma documentation doesn't show how to turn on the last one in the account (in the API it is the notify_internal parameter, off by default). Can't find the toggle? Ask Zadarma support. Elbuz skips the “answer” and voice menu events.

    The webhook address card in the Zadarma form
    1Address for the provider
    2Copy button
    1. The address you give to the provider; the secret key at the end is masked in the frame.
    2. The “Copy” button — puts the address in the clipboard.

    Zadarma signs every notification with the API secret, and Elbuz accepts only those whose signature matches the secret in the form. If you reissued the keys in Zadarma and didn't update the secret in Elbuz, notifications are silently rejected and the log is filled only by reconciliation. After any key change, re-enter both fields and click “Test connection”.

    The address contains a 32-character secret key and the host of the address you opened the form from. Open the settings from the domain you always use. Changed the domain? Copy the address again and replace it in Zadarma.

    To get Zadarma working with Elbuz

    What reaches Elbuz

    FeatureHow it works with Zadarma
    Call from the card and the log (“Call”)yes: Zadarma first rings the manager's extension, then the customer. If “Line for outgoing calls” is filled in, the customer sees that number
    Incoming calls in the logyes, on the call end notification; calls between employees don't go to the log
    Outgoing calls in the logyes, on the outgoing call end notification
    Incoming call card while the phone ringsyes, if the notification about an incoming call starting on an extension is on (incoming call card)
    Call recordingyes: Elbuz requests the link from Zadarma when you click “Play recording”
    Call result“Answered”, “Busy”, “Canceled”, “No answer”, “Connection failure” — this is how Elbuz maps Zadarma statuses
    Hourly log reconciliationyes, at minute 25 of every hour, for the past 24 hours
    Wait time separate from talk timeno: Zadarma returns only the total duration, the wait column is zero
    Customer name on the phone screenno: Zadarma doesn't ask the for the caller's name
    Hang up from the incoming call cardno: Zadarma has no such API method
    Voice AI employeeyes, incoming and outgoing (number to AI)

    Zadarma specifics

    Which notifications Elbuz processes

    • Start of an incoming or outgoing call — Elbuz looks up the customer by number.
    • Start of an incoming call on an extension — shows the card to the manager.
    • End of a call — puts the call in the log with its duration, result and a recording flag.
    • Recording — arrives after the call ends; Elbuz finds the call already in the log and marks that a recording exists.

    Incoming call card

    Elbuz shows the “Incoming call” card to the manager whose extension is being called. In the incoming call start notification, Zadarma sends the customer's number, your number and the time, but not the extension — it first appears in the “start of an incoming call on a PBX extension” notification.

    • The notification is off — the card won't pop up during the call, but the call goes to the log after it ends, and the “Missed call” card appears if the call end notification contains the extension.
    • A call from one employee to another (both numbers are short) — there is no card, and the call doesn't go to the log either from notifications or during reconciliation.

    Call recordings

    Elbuz doesn't store recordings itself. When you click “Play recording”, Elbuz asks Zadarma for a link to that call; if the call has several recordings, the first one is used. So you can play a recording as long as Zadarma keeps it — how long depends on your Zadarma plan.

    Hourly reconciliation and Zadarma limits

    Every hour Elbuz fetches PBX call statistics for the past 24 hours from Zadarma and adds what the notifications missed. Zadarma returns statistics in batches of up to 1,000 calls, for no more than 30 days at a time, and allows only a few statistics requests per minute.

    If the limit is used up, Elbuz waits for it to reset (when that is a little over a minute away). If that's not enough either, it saves what it already has, and the next reconciliation fetches the rest.

    How to route a Zadarma number to voice AI

    Voice works apart from the integration above: calls are handled by the Elbuz voice platform, not your PBX, so the number must be routed to it. You set it up in “Voice on the phone” in the AI employee card; what AI says and how it calls from processes — see Voice AI employee. Below — only the Zadarma steps.

    Incoming: how to route a number to AI

    In the “Voice on the phone” section, enter the Zadarma number AI should answer on, and leave Zadarma in the “Operator” field. The section shows an address like <number>@<SIP-domain> — the number without “+”, then the Elbuz voice platform domain. Copy it with the “Copy” button and use one of two methods in your Zadarma account.

    The whole number to AI (forwarding the virtual number itself):

    1. “Settings” → “Virtual numbers”.
    2. Click the the number is connected to.
    3. Select the “external server” option and paste the copied address.

    Through a PBX extension (calls to the number follow the PBX scenario, and reach AI from the extension you choose):

    1. “My PBX” → “Extensions”.
    2. In the extension settings, click “Enable” next to “Call forwarding and voicemail”.
    3. Choose a condition, for example “Always”.
    4. In “Forward to”, choose “External server (SIP URI)” and paste the address.
    5. Click “Save”.

    Zadarma asks you to allow calls from its addresses on the receiving side. When Zadarma is selected in the “Voice on the phone” section, Elbuz does this itself: it accepts calls to your SIP address only from Zadarma subnets.

    Outgoing: SIP line for AI calls

    For outgoing calls, AI registers with Zadarma as a regular SIP phone on one of the PBX extensions. Create a separate extension for AI: one SIP account means one registered device.

    Field in ElbuzWhat to enterWhere to find it in Zadarma
    “SIP server”pbx.zadarma.com; if the field is empty, Elbuz fills it in for Zadarma itselfthe PBX SIP proxy address from the Zadarma instructions
    “Line login”an extension like 12345-101“My PBX”: PBX ID, a hyphen, the short extension
    “Line password”the password of this extension; after saving, the field shows “saved — type to replace”“My PBX” → “Extensions”
    “Number shown to the customer”the number the customer will see; leave empty to use the same as for incoming callsthe list of your numbers
    “Call during hours”9-20 by default, in the account's time—

    Outgoing calls work only with “Answer calls” turned on — otherwise “Test call” replies “Outgoing calls are not set up: enter the line login and password and turn on answering calls”.

    The Elbuz voice platform calls through Zadarma from abroad, so for outgoing AI calls the category of the number in “Number shown to the customer” matters:

    • “National” and city numbers (for example, Vinnytsia) can't make calls from abroad — outgoing AI calls won't go through with them;
    • “Mobile” numbers can, according to Zadarma support; we haven't confirmed this with a live call yet, so make a “Test call”;
    • a number from another country, for example from the EU, works.

    You can see the category in your Zadarma account in the list of your numbers, in the country and city column. AI accepts incoming calls on a number of any category.

    Scenarios

    Managers call from the CRM, the head of sales listens to calls

    Complete the three connection steps and enter a short extension for each manager. “Call” starts working from the card and the log, and recordings can be played from the log while Zadarma keeps them.

    Managers take some calls, AI takes the rest

    Route a PBX extension to AI, not the whole virtual number: calls then follow your PBX scenario, and AI gets only those that reach this extension (incoming to AI).

    AI confirms every new order

    Create a separate extension for AI, enter its login and password in “Outgoing calls”, and in “Number shown to the customer” a number that can call from abroad. Make a “Test call”, then build a Flows process with an “AI call” block (confirm an order).

    What to do when calls don't come through

    What Elbuz shows and what to do about it
    What you seeWhyWhat to do
    There is no “Call” button in the contact list or in the card The keys aren't entered or the “Active” toggle is off — then call buttons aren't shown at all Check the fields and the toggle in the connection form (step one)
    “Your employee card has no extension number” The “Internal phone” field in your card is empty: the PBX has nowhere to call in the first step Enter the number in the employee card (step two)
    Calls are in the Zadarma account, but show up in the log only an hour later Notifications don't arrive: the address isn't added in Zadarma, it has an old domain, or the signature doesn't match because the secret was replaced Copy the address from the “PBX webhook address” card again, check it in the Zadarma notifications and re-enter the secret (step three)
    “Connected to the PBX”, but the “PBX extensions without an Elbuz employee” line shows only numbers without names That's expected: Zadarma returns the list of extensions without names Compare the numbers with your Zadarma account and enter them in the cards of the matching employees
    “The PBX did not answer in time. If the call did start, it will show up in the call log — check it before dialing again” The operator didn't respond within 15 seconds. The request may have been accepted — then your phone will ring a bit later Don't dial again right away: wait a minute. If the PBX accepted the request, your phone will ring, and the call will appear in the log after the conversation
    An outgoing AI call to a customer doesn't go through, although AI accepts incoming calls “Number shown to the customer” has a “National” or city number: such numbers can't make calls from abroad In “Number shown to the customer”, enter a “Mobile” number (according to Zadarma support) or a number from another country, for example from the EU, and make a “Test call”

    Other cases are in the general troubleshooting of Telephony in Elbuz, and problems with AI conversations are in the troubleshooting of Voice AI employee.

    FAQ

    Where do I get the Zadarma key and secret for Elbuz?

    In your Zadarma account: “Settings” → “Integrations and API”, the API keys page my.zadarma.com/api/. Enter the key in the “API key” field and the secret in “Secret” in the Zadarma row of the “Telephony” group.

    Where in Zadarma do I paste the address from Elbuz?

    “Settings” → “Integrations and API”, in the notifications block — the “Notifications about calls in PBX” field, then “Enable”. Elbuz passes the Zadarma test request on save by itself.

    Can I play a Zadarma call recording from Elbuz?

    Yes. “Play recording” in the log asks Zadarma for the link at the moment you click it. Elbuz doesn't copy recordings, so you can play one as long as Zadarma keeps it.

    Why doesn't the incoming call card pop up with Zadarma?

    Zadarma names the extension being called only in the “start of an incoming call on a PBX extension” notification (NOTIFY_INTERNAL). Turn it on in Zadarma; can't find the toggle — ask Zadarma support.

    How do I route a Zadarma number to voice AI?

    Copy the number@SIP-domain address from the “Voice on the phone” section and paste it in Zadarma as the “external server” of the virtual number or as “External server (SIP URI)” in the extension forwarding (steps).

    What do I enter so that AI calls customers through Zadarma?

    The SIP server pbx.zadarma.com, an extension login like 12345-101 and its password, and in “Number shown to the customer” a number that can call from abroad (outgoing AI calls).

    Two telephony services are connected — which one does “Call” use?

    The first active configured one. Elbuz can't call through Zadarma and another operator at the same time.

    Will the manager see the customer's name on the phone screen?

    No: Zadarma doesn't ask the CRM who is calling, so the phone shows only the number. The name and orders are shown in the “Incoming call” card in Elbuz.

    Where to find it and who has access

    Menu
    Account → System settings → “Other settings” → “External services and integrations” → “Telephony” → Zadarma
    From the log
    the menu of the “Call log” window → “Telephony connection”
    Extension
    “Users” → employee card → “Internal phone”
    Voice AI
    Directories → Contacts → Pulse → “Agents” → “Agent settings” → “Voice on the phone”
    Access right
    system settings and the “Call log” window; for voice, “Management”
    Prepare
    the Zadarma API key and secret, a PBX extension for each manager

    The window that opens from the operator row is called “API access settings for external services”. Without the right to “Call log”, “Test connection”, the webhook address and the settings file don't work; you don't need the right just to make calls. The general mechanics — log, call card, permissions — are in Telephony in Elbuz.

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free