Calls by API: errors Briefly A refused call action is 409 call_refused, the reason is in reason. Each reason comes with what it means and what to do. Good to know. For programmers. If you are not a programmer, the article you need is Start here .
Errors come in the same { error, description, data } envelope as in the rest of the API . A refused call action is 409 with error: call_refused, the reason is in data.reason.
HTTP Code Meaning and what to do 400 invalid_requestWrong fields, which ones — in data: a number not of 7–15 digits, an operator_id not from /operators/, a wrong history parameter. Fix the fields from data and repeat. 401 unauthorizedNo key, a broken one or a revoked one. Check the Authorization header or create a new key. 403 forbiddenThe key lacks the calls:voice permission. Create a Key for calls . 404 not_found, channel_not_foundNo such call or line for this key: someone else’s line, a line not chosen for the key, a hidden dialogue. Tick the line in the key. 409 call_ownedThe call is already someone’s: an operator or another key took it. The program has nothing to do. 409 call_not_yoursVoice and this action are only for your key’s call. Accept the call first: accept. 409 call_not_ringingThe call no longer rings: it was taken or it ended. See what happened to the call: GET /calls/<id>/. 409 call_not_transferableThe call cannot be transferred now: it is not in conversation, for example the client still hears the ringing. Repeat once the client answers. 409 transfer_unsupportedThe line’s messenger cannot hand a call on in the middle of a conversation (WhatsApp Cloud, MAX). Finish the talk with the program or hang up. 409 command_in_progressThe previous command on the call is still running: repeat a little later 409 calls_unsupportedThe line does not call: its type, or calls are off on it. Turn the line’s calls on: Channels → the line’s gear → Calls . 409 contact_refuses_automationThe client asked not to be called automatically: TehProf Dialogs does not call them. An operator can call them. 429 rate_limitedToo often. How long to wait — in Retry-After
Request rate limits are the same as in the rest of the API : lists, history and summaries count as reads, commands and voice as sends. The voice connection’s close codes are in Commands and voice .
Related articles Getting started What TehProf Dialogs does, the first step, the trial and payment
Start here — How to connect a WhatsApp number to Bitrix24 or amoCRM: find your case in the table — QR, the official API or Coexistence — and open the matching guide.What TehProf Dialogs is — TehProf Dialogs connects WhatsApp to Bitrix24 and amoCRM: chats, calls with recording and transcripts, groups, three ways to connect and prices in tenge.Which way to connect — How WhatsApp Web by QR differs from the official WhatsApp Business API for a CRM: the phone app, templates, groups and calls. How to choose a method.Trial and payment — How the 3-day trial works, how to issue an invoice for a WhatsApp line and pay it by transfer, how to renew the term and what happens when it ends.Dialogs in 10 minutes — TehProf Dialogs training: chats, dialogues, calls, analytics, channels and settings, who sees what, connecting AI and what to know from day one.Connect WhatsApp By QR code, a new number through Meta, a number from your phone or another provider
WhatsApp Web via QR code — WhatsApp Web by QR connects your number to Bitrix24 and amoCRM. The link is unofficial; the official API avoids that, but complaints can still limit a number.Connect a new official number — Connect a new number to the official WhatsApp Business API from Meta and your CRM: the path for a number not yet in WhatsApp, without the QR restriction risk.Keep WhatsApp Business on the phone — Coexistence connects the official WhatsApp Business API to a number that stays in the WhatsApp Business app: chats in the CRM, replies from the phone as well.Number at another provider — The number works at another WhatsApp API provider: connect it to TehProf Dialogs without moving it and switch replies in Meta Business Suite.Facebook window step by step — What to prepare and what to press in the Meta window when connecting official WhatsApp: sign-in, terms, number, code, business portfolio and line check.Company in Meta — Meta reviews the company, the number’s display name and Official Business Account (OBA) status separately: what to check for the official WhatsApp API.Meta terms in plain words — Business portfolio, WABA, display name, business verification, the 24-hour window, templates, limits, Coexistence and OBA: official WhatsApp API terms.What Meta charges — Meta's prices for templates, replies and calls on official WhatsApp in Kazakhstan, Russia, Uzbekistan, Kyrgyzstan and nearby countries, and what is free.Telegram and MAX Your own Telegram and the MAX messenger in Bitrix24 and amoCRM, next to WhatsApp
Telegram for Bitrix24 — How to connect your own Telegram to Bitrix24: sign in by QR code or phone number, chats in Open Channels, the Telegram source in the CRM, calls from Bitrix24.Telegram for amoCRM — How to connect your own Telegram to amoCRM: sign in by QR code or phone number, chats in the native amoCRM chats with their own source, calls from the card.MAX for Bitrix24 — MAX integration for Bitrix24: how to connect, how chats reach Open Channels next to WhatsApp and Telegram, what works for calls and the price.MAX for amoCRM — MAX integration for amoCRM: how to connect, how chats reach amoCRM next to WhatsApp and Telegram, what works for calls and the price.Bitrix24 Open Channels, WhatsApp campaigns, the «Unread» mark, robots and calls in the deal
Bitrix24 quick start — How to connect WhatsApp to Bitrix24: install the app, select a channel, connect an Open Line and test an incoming message and a reply with illustrated steps.WhatsApp campaigns — WhatsApp campaigns from Bitrix24 CRM Marketing: approve a template, prepare the file and send via the official number; segments are set in Bitrix24.“Not read” label — The “Chat with client: Not read” label on a Bitrix24 deal: when it clears, what TehProf Dialogs does and which settings change it.Message mode for the CRM — Three modes per channel: open line, Dialogs create the card, or create nothing. What to choose, how a customer is matched, and what if a stage is gone.Bitrix24 automation — How to send WhatsApp messages automatically from Bitrix24: first test a manual send from the line, then a CRM administrator adds the robot to a stage.A call in the deal and CRM feed — Where a WhatsApp call lands in Bitrix24 and amoCRM: card and deal, the “TehProf Dialogs” label, comment, recording and transcript, the new-number setting.amoCRM Connecting, chats, calls and tasks in the client card
amoCRM quick start — Install the app, connect a WhatsApp line to amoCRM and test an incoming message and a reply. Steps, screenshots and connection checks.Chatting with clients Signing in, replying, replying after a day of silence, saved replies and templates, notifications
The Dialogs workspace — The conversation list is on the left, the message thread in the centre and customer details on the right. Select a chat to reply from the company number.Sign in to Dialogs — Sign in by phone with a code in WhatsApp or Telegram, by an email link, with a password, Google or Yandex; from your CRM; and what to do when sign-in fails.Reply to a customer — How to reply to a customer on WhatsApp in TehProf Dialogs and start a new chat from the company number; if a message is not delivered, check the failed send.Files in the CRM card — Bitrix24 card files show as thumbnails and open in Dialogs. A chat file is dragged into a field and removed from it; a file link is copied.When an official template is required — On official WhatsApp, you have 24 hours after the customer’s latest message to reply in plain text. Each new customer message starts these 24 hours again.WhatsApp Web saved replies — On a WhatsApp Web line a template is a saved team reply: it is available as soon as you save it, without Meta review, and variables change the customer name.Official templates — How to create and send an official WhatsApp template: all numbers in one WhatsApp Business account share templates; stats and quality are in WhatsApp Manager.Own templates in any chat — Personal and shared WhatsApp templates work in a chat on any line: create one in a single step, find it by search, send it, and who may change shared ones.Meta templates in any chat — How to send a Meta template from a WhatsApp Web line chat, what happens to variables and buttons, and how to save a good message as a template.Finding templates — How to find a WhatsApp template fast: favorites and recents on top, the “Meta” switch, search, filters, “/” in the message field and the admin’s selection.Notifications — When TehProf Dialogs shows a new-message notification and a sound, how to get an alert when a WhatsApp line disconnects, and what to do if nothing arrives.Language and theme — How to switch the TehProf Dialogs interface language and the light or dark theme: the controls in the header, your choice is saved for your account.App on your phone — How to add Dialogs to your phone home screen (Safari on iPhone, Chrome on Android) and turn on notifications about messages and calls.WhatsApp calls Taking calls, who gets them and how to call a client
Incoming WhatsApp calls — How to set up incoming WhatsApp calls in Bitrix24 and amoCRM: the call rings for managers, and the recording and transcript stay in the client card.Call distribution — How a WhatsApp call goes through steps 1-2-3: first to the responsible employee and staff in TehProf Dialogs, then to the WhatsApp of a department.Calls to a PBX (Sipuni) — How to send WhatsApp calls to your own PBX: the connection in TehProf Dialogs, the Sipuni account fields, a test call and what to check.Dialer — How to call a customer on WhatsApp from TehProf Dialogs: recent and missed calls, the keypad, the default line and digits during a call.Calls only: what it is — The «Calls only» plan in TehProf Dialogs: one WhatsApp dialer instead of chats, call recording in Bitrix24 and amoCRM, who it suits and how it differs.Calls only: price — The price of «Calls only»: 15 000 ₸ a month on a QR line and an official one, the surcharge for calls with messaging, and Meta fees for outgoing calls.Calls only: our line — How to connect a «Calls only» line on ordinary WhatsApp by QR code: open «Channels», link the phone and test a call. WhatsApp may impose restrictions.Calls only: official number — What an official WhatsApp number needs for calls: a messaging limit of 2000, a payment method, no coexistence mode, the call icon and Meta’s rules.Calls only: incoming — How to take an incoming WhatsApp call in TehProf Dialogs: the call card, «Accept» and «Reject», microphone access and what to do if nothing is heard.Calls only: place a call — How to call from the «Calls» section: dial on the «Keypad», call back from «Recents», pick the line under «Calling from» and make one the default.Calls only: permission — How to get a customer’s permission to call from an official WhatsApp number: the «Call permission request» window, «Send request», Meta’s terms and limits.Calls only: journal — Where to see call history in TehProf Dialogs: the «Recents», «All» and «Missed» tabs, the result of a call and how to call a missed number back quickly.Calls only: CRM — How «Calls only» calls work in amoCRM and Bitrix24: the dialer in the CRM panel, the call recording in the client card or deal, and what it takes.Calls only: questions — Answers about «Calls only»: the 100 calls a day limit, the call icon delay of up to 7 days, countries without outgoing calls, and adding messaging.Team Access for staff and several managers working without double replies
Team and access — How to give employees access to WhatsApp in Bitrix24: app access, Open Line permissions, a place in the queue and call recipients in Bitrix24 telephony.Security and sign-in — Why sign-in uses a code, what “address confirmed” means, who can hold an address and what to do if you suspect someone else signed in.Signing in — Sign in to TehProf Dialogs with a code by email or phone: steps, and what to do if the code did not arrive, the address is taken or you must choose a company.Sign in from Bitrix24 — How an employee opens Dialogs from Bitrix24, why an address from the CRM does not open the cabinet by itself, and how to confirm an email or phone.Sign in from amoCRM — How an employee opens Dialogs from amoCRM, why an address from the CRM does not open the cabinet by itself, and how to confirm an email or phone.Access check — How Dialogs compares your team with the CRM employee list, when it closes access by itself and why a mass disappearance is left to the administrator.Accepting documents — When TehProf Dialogs asks you to accept documents at sign-in, how the single tick works, and how an owner or administrator differs from an ordinary employee.Switching between CRMs — How to connect Bitrix24 and amoCRM to one company at the same time, what “Primary” and “Secondary” mean, and how to move WhatsApp lines between the programs.Team replies — How a team replies to WhatsApp customers without duplicates: choose your main workspace for replying — TehProf Dialogs or a Bitrix24 Open Line.AI assistant Your own Claude or ChatGPT from its directory: it searches, retells calls, drafts replies
First connection through AI — How to start with TehProf Dialogs from Claude or ChatGPT: sign-in by link, a WhatsApp line by QR code and the first reply to a customer after you confirm.Connect AI — Connect Claude, ChatGPT, Cursor, VS Code, Codex or Gemini CLI to WhatsApp in your CRM through MCP: the AI drafts replies and a person sends them.If something does not work The line dropped, a message failed, an error while connecting through Facebook
When WhatsApp does not work — Common TehProf Dialogs problems: the line went offline, messages do not reach Bitrix24 or amoCRM, a call does not ring, a template is not sent, sign-in fails.Delivery problems — If a message appears in TehProf Dialogs but not in Bitrix24, check the Open Line, the queue and employee access: how to check a failed send.Facebook problems — The Facebook window did not open, no business portfolio, number already registered, no code, display name rejected, templates not sent: what to do.For developers: Gateway API Sending messages and templates from your system, webhooks, limits, calls from a program
Gateway API: getting started — One WhatsApp API in TehProf Dialogs: receive messages on your own webhook and send replies with a single POST from a bot, an n8n flow or your own service.Sending messages — Send a message. POST /messages/ — text, a file or a template. A file may carry text as its caption; a template does not combine with text or a file.Message templates — Create an official WhatsApp template through the Gateway API: POST /templates/, a lowercase name and a required body_text; the verdict from Meta comes later.Webhooks: inbound events — How to register a Gateway API webhook: PUT /webhook/ with your https URL and streams, the hmac_secret that signs deliveries, and replacing a subscription.Missed deliveries — Gateway API subscriptions: GET /subscriptions/ shows the state and watermark of every line, so you can catch up on WhatsApp events your webhook missed.Errors, n8n and limits — Gateway API errors come in one envelope { error, description, data }: the main codes, working with n8n and limits when sending WhatsApp messages.Calls by API — Your program takes and places WhatsApp calls on TehProf Dialogs lines, speaks and listens, and hands the client to the line’s people. Key with calls:voice.Calls by API: commands and voice — How a program places, accepts, transfers and ends calls, how it speaks and listens to the client, and how it learns about new calls.History and call summary — Finding ended calls by what happened in the conversation, a client’s repeat calls and the call summary in numbers — from the recording’s sound, no AI.Calls by API: Python SDK — The dialogs-sdk package for Python: installing it, a first bot that answers and hands the client to people, and a sandbox check without a phone.Calls by API: errors — Refusal codes of the calls API, what they mean and what to do: key permissions, someone else’s call, transfer, a client who refuses automated calls.Comparisons and prices Which way to choose, prices in tenge, how we compare with other services
Three ways to connect WhatsApp — Official WhatsApp Business API, Coexistence or WhatsApp Web by QR: how the phone app, templates, groups and calls differ. QR carries a risk of restrictions.Dialogs or Wazzup — TehProf Dialogs and Wazzup compared by the Wazzup site on 7 November 2026: connecting a number, prices, CRM. For anyone seeking a Wazzup alternative.Dialogs or ChatApp — TehProf Dialogs and ChatApp compared by the ChatApp site on 7 November 2026: connection methods, plans, calls, groups, AI assistant. A ChatApp alternative.Dialogs or Radist — TehProf Dialogs and Radist.Online compared by the Radist site on 7 November 2026: connecting WhatsApp, CRM, groups, calls. A Radist alternative.Dialogs or Umnico — TehProf Dialogs and Umnico compared by the Umnico site on 7 November 2026: connecting WhatsApp, CRM, groups, chatbots, prices. An Umnico alternative.Prices in tenge — What WhatsApp in a CRM costs in Kazakhstan: WhatsApp Web from 12 000 ₸ a month, the official API and Coexistence from 18 000 ₸, plus connection.How to choose an integration — How to choose a WhatsApp integration for Bitrix24 and amoCRM: connection method, calls, recording, groups, prices in tenge; vs Wazzup, ChatApp, i2crm.WhatsApp for Bitrix24 — WhatsApp in Bitrix24: chats in Open Channels, calls and history in the client card, robots on deal stages, Marketplace install. From 12 000 ₸/month.WhatsApp for amoCRM — WhatsApp in amoCRM: messaging in standard chats, calls with recording, WhatsApp templates and Salesbot. Install from amoMarket, connect a number by QR.WhatsApp calls in your CRM — WhatsApp calls in Bitrix24 and amoCRM: answer in the browser or the Bitrix24 mobile app, with history, recording, transcript and a summary in the client card.Call recording and transcripts — WhatsApp call recording in Bitrix24 and amoCRM: audio, transcript and summary in the client card. Record only if the other person is warned and agrees.WhatsApp for sales teams — How several managers answer customers from one WhatsApp number: access per employee and department, the Bitrix24 queue, call distribution, chats in the card.Official WhatsApp in Kazakhstan — The official WhatsApp Business API in Kazakhstan: Meta business portfolio, company verification, templates, the 24-hour window, Meta fees and a CRM link.Official calls: Calling API — WhatsApp Business Calling API rules: the customer calls you, you call the customer only with permission, where outgoing calls fail, Coexistence, recording.WhatsApp in 1C and other CRMs — How to connect WhatsApp to 1C, Megaplan, your own CRM or a bot through TehProf Dialogs: the open API, a connection by TehProf.kz, and working without a CRM.What’s new Bitrix24 card files: visible, dragged in, removed — Files in card fields show as pictures and open over the chat. A file from the chat is dragged into a field, and one not needed is removed with a cross.amoCRM: chats, calls and a self-replying bot (Salesbot) — A line writes into amoCRM chats, calls land in the card, and WhatsApp templates and the amoCRM bot that replies by itself (Salesbot) work from the CRM.Call route: steps in order, each with its own time — The Calls tab is now a 1-2-3 route: the responsible employee, staff and departments in TehProf Dialogs, then WhatsApp. Each step has its own wait.The “Not read” label in Bitrix24 now clears itself — When the responsible opens the chat in TehProf Dialogs, the “Not read” label on the Bitrix24 deal disappears. Three switches change who clears it and when.WhatsApp call in the deal and CRM feed: recording and summary — A call through a TehProf Dialogs line lands in the client card and deal in Bitrix24 and amoCRM: the “TehProf Dialogs” label, recording and a short summary.Dialer in the chat: recent calls, keypad and digits — Call a customer back with one tap: recent and missed calls, a keypad for any number, digits during a call and a default line in TehProf Dialogs.Your own templates in any chat: favorites, recents and “/” — Personal and shared WhatsApp templates work on any line. Favorites and recents sit on top, and “/” in the message field inserts a template in a second.Meta templates in a web-line chat and “Save as template” — Approved Meta templates can be sent from a WhatsApp Web chat, and a good message can be saved as a template from the message menu in TehProf Dialogs.
