Open in
Използвайте собствените си номера (VoIP, API)
Свържете Twilio, Telnyx, SignalWire, Vonage, Plivo или друг SIP транк чрез SIP, импортирайте телефонните номера, които вече притежавате, и позволете на агентите на ThunderPhone да приемат и осъществяват обаждания с тях.
Одобрените номера на ThunderPhone могат да извършват изходящи обаждания и да изпълняват кампании. Ако предпочитате да използвате собствени номера чрез ваш доставчик на VoIP, това ръководство ви превежда през процеса на свързване: тествайте идентификационните данни → създайте връзка → импортирайте номера → потвърдете.
Поддържани доставчици
| Доставчик | provider id | Бележки |
|---|---|---|
| Twilio | twilio | SID на акаунта + токен за удостоверяване; една връзка за всеки акаунт или подакаунт в Twilio (вижте подакаунти в Twilio) |
| Telnyx | telnyx | API ключ; налично е водено въвеждане (setup_method: guided_telnyx) |
| SignalWire | signalwire | Няма собствена връзка с доставчик; свържете го като manual с предварителната настройка за SignalWire SIP |
| Vonage | vonage | Няма собствена връзка с доставчик; свържете го като manual с предварителната настройка за Vonage SIP |
| Ръчен SIP | manual | Всеки SIP trunk, включително SignalWire, Vonage и Plivo. Ако започнете от някоя от плочките на тези доставчици в таблото, връзката остава manual и съхранява избора в sip_config.preset (signalwire, vonage или plivo) |
1. Тествайте идентификационните данни
Преди да създадете запазена VoIP връзка, проверете идентификационните данни на доставчика, за да потвърдите, че работят. Това връща
verification_evidence_id, който подавате към стъпката за създаване, така че
идентификационните данни да не бъдат таксувани два пъти за тестване.
curl -X POST https://api.thunderphone.com/v1/voip-connections/test \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"provider": "telnyx",
"credentials": { "apiKey": "KEY...", "connectionId": "123456" },
"sip_config": { "domain": "acme.sip.telnyx.com" }
}'{
"status": "pass",
"verification_evidence_id": "b9a2...",
"suggested_connection_name": "Telnyx: Acme Main (+15550001234)",
"checks": {
"credentials_valid": true,
"inbound_reachable": true,
"outbound_authorized": true
}
}Ако някоя проверка е неуспешна, status в отговора ще бъде fail, а checks
ще покаже коя стъпка е дала грешка. Коригирайте конфигурацията от страна на доставчика
(присвояване на trunk, IP списък с разрешени адреси, разрешение за изходящи обаждания) и опитайте отново.
2. Създайте връзката
Подайте verification_evidence_id, който току-що получихте:
curl -X POST https://api.thunderphone.com/v1/voip-connections \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Telnyx Main",
"provider": "telnyx",
"setup_method": "api_key",
"credentials": { "apiKey": "KEY...", "connectionId": "123456" },
"sip_config": { "domain": "acme.sip.telnyx.com" },
"verification_evidence_id": "b9a2..."
}'Отговорът е обект VoipConnection
с status="connected". Идентификационните данни и другите тайни стойности за връзката се съхраняват от страна на сървъра и никога
не се връщат в обикновен текст при последващи GET заявки — за да ги смените, изпълнете нов
test и PATCH с новите доказателства.
Подакаунти в Twilio
Връзката с Twilio е обвързана с единствения акаунт в Twilio, чиито Account SID и Auth Token съдържа. Twilio съхранява телефонните номера и SIP транковете във всеки подакаунт, така че връзка, създадена с родителския акаунт, вижда само собствените номера на родителския акаунт, а съществуваща връзка не може по-късно да бъде превключена към друг подакаунт.
За достъп до номерата в подакаунти създайте по една връзка за всеки подакаунт. Таблото за управление прави това вместо вас: когато свържете родителски акаунт с активни подакаунти, диалоговият прозорец за настройка ги изброява, вие отбелязвате желаните и ThunderPhone създава връзка (и SIP транк) във всеки от тях. Същият процес е наличен чрез API:
# Discover active subaccounts visible to the parent credentials
curl -X POST https://api.thunderphone.com/v1/voip-connections/twilio/subaccounts \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"credentials": {"accountSid": "ACparent...", "authToken": "..."}}'{
"discovery_id": "7c1e...",
"parent": { "sid": "ACparent...", "friendly_name": "Acme" },
"subaccounts": [
{ "sid": "ACsupport...", "friendly_name": "Acme Support", "already_connected": false, "connection_id": null },
{ "sid": "ACsales...", "friendly_name": "Acme Sales", "already_connected": true, "connection_id": 5 }
]
}# Create a connection for each selected subaccount
curl -X POST https://api.thunderphone.com/v1/voip-connections/twilio/subaccounts/connect \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"discovery_id": "7c1e...", "subaccount_sids": ["ACsupport..."]}'Отговорът съдържа по един ред за всеки подакаунт със status created, skipped (вече е свързан) или failed, както и error, по която можете да предприемете действие. Редовете са независими, така че неуспех в един подакаунт никога не блокира останалите, а discovery_id остава валиден 30 минути, така че неуспешен ред може просто да бъде повторен. Токените на подакаунтите се прочитат от Twilio при откриването и се съхраняват в новата връзка; никога не се връщат от API. Всяка нова връзка след това импортира и потвърждава номера точно както връзка, която сте създали ръчно. Добавете "enable_transfers": true, за да активирате и прехвърлянето на обаждания за SIP trunk на всяка нова връзка; неуспехът при това се отчита в test_result.transfer_enable_error на съответната връзка и не води до неуспех на реда.
3. Избройте и импортирайте номера
Проверете номерата, видими за вашите идентификационни данни, които все още не са в организация на ThunderPhone:
curl https://api.thunderphone.com/v1/voip-connections/5/available-numbers \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"След това импортирайте желаните:
curl -X POST https://api.thunderphone.com/v1/voip-connections/5/import-numbers \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"numbers": ["+15550001234", "+15550009999"]}'Всеки импортиран номер става ресурс за телефонен номер
във вашата организация с number_type="voip" и status="provisioning".
Запазете собственото си маршрутизиране на обаждания
В Twilio импортирането поставя номера в SIP trunk-а на ThunderPhone във вашия акаунт; в Telnyx то присвоява номера към SIP връзката на ThunderPhone. И в двата случая всяко обаждане след това отива директно към вашия агент.
За да маршрутизирате обажданията сами вместо това (например първо да позвъните
на човек и да изпратите обаждането към агента само ако не отговори), променете
настройките за гласови обаждания на номера при вашия доставчик след импортирането
или импортирайте чрез API с "call_routing": "customer", така че ThunderPhone
изобщо да не ги променя. ThunderPhone никога не ги променя обратно. За да
отговори агентът, изпратете обаждането към SIP адреса на номера:
<Response>
<Dial>
<Sip>sip:+15550001234@sip.thunderphone.com</Sip>
</Dial>
</Response>Изпращането на текстови съобщения чрез номера работи еднакво и в двата случая. Тестът за входящо обаждане се обажда на номера, така че достига до този, към когото вашето маршрутизиране изпраща обажданията първо.
Преместване на номер между връзки
Импортирането на номер, който вече е в друга ваша връзка, го премества към новата заедно с неговите агенти и история. Номер, който връзка с Twilio или Telnyx изпраща към ThunderPhone, трябва първо да бъде премахнат от тази връзка, тъй като доставчикът му би продължил да изпраща обажданията там.
4. Проверете всеки импортиран номер
Импортирането регистрира номера като наличен; за реалното маршрутизиране на обаждания през него е необходима верификация. При връзки с доставчици (Twilio, Telnyx) това проверява отново идентификационните данни на доставчика и SIP достъпността. При ръчна SIP връзка първо се опитва самообаждане в затворен цикъл: ThunderPhone извършва кратко тестово обаждане от номера, през вашия SIP транк, обратно към същия номер. Ако това не потвърди входящия път, се преминава към кратко тестово обаждане от номера, през вашия SIP транк, към номер на ThunderPhone. Тези тестове проверяват потребителското име, паролата, транспорта, изходящото маршрутизиране и входящата доставка на транка. Вашият оператор таксува тези обаждания като всички останали.
curl -X POST https://api.thunderphone.com/v1/phone-numbers/{id}/verify-voip \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"При успех voip_verification_status се променя на verified, а
номерът преминава в status="active". Номер във ваш собствен акаунт в Telnyx
продължава да приема входящи обаждания, когато тестовото му обаждане е неуспешно или
изходящите обаждания все още не са настроени: той преминава в status="active" с
voip_verification_status, зададен на unverified, а отговорът посочва причината. При неуспех
отговорът описва
какво не е сработило — за ръчен SIP trunk това е SIP отговорът на доставчика, например „отхвърли идентификационните данни на ThunderPhone (SIP 401)“ или „не можа да маршрутизира обаждане (SIP 404)“ — коригирайте го (идентификационни данни, разрешени IP адреси на източника, липсващо присвояване на trunk в таблото за управление на доставчика) и опитайте отново.
При ръчна SIP връзка със списък с разрешени адреси тестът за входящо повикване също е неуспешен, ако тези разрешени IP адреси на източника биха блокирали реално входящо повикване. Ако използвате IP адреси на ретранслатора на ThunderPhone в своя списък с разрешени адреси, включете всеки IP адрес на ретранслатора, който ThunderPhone ви предоставя за вашата настройка.
5. Присвоете агенти и приемете обаждане
След като номерът е потвърден, присвоявате агенти за входящи / изходящи обаждания по същия начин като за номер на ThunderPhone. Вижте Обработване на входящи обаждания и Извършване на изходящи обаждания.
Обажданията от номера на ThunderPhone могат също да набират дестинации извън САЩ и Канада, когато ThunderPhone има тарифа за съответната държава и тип линия. Тези обаждания се таксуват според тарифата за дестинацията.
Ротация на идентификационни данни
Когато ключът на доставчик се ротира, изпълнете отново процеса за тестване и след това актуализиране:
# 1. Test the new credentials
curl -X POST https://api.thunderphone.com/v1/voip-connections/test ...
# 2. PATCH the connection with the new evidence
curl -X PATCH https://api.thunderphone.com/v1/voip-connections/{id} \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"credentials": { "apiKey": "NEW_KEY..." },
"verification_evidence_id": "fresh-evidence-id"
}'Връзката остава активна — не е нужно да импортирате отново номерата. В процеса за повторно свързване в таблото за управление можете сигурно да въведете новия ключ на телекомуникационния доставчик, без да заменяте целия съхранен обект с идентификационни данни в обикновен текст.