ThunderPhone v3 вече е тук.Започнете самостоятелно — от 2 цента/мин.Прочетете съобщението

Getting Started

ThunderPhone CLI

Влизайте в профила си, управлявайте гласови агенти и обаждания, конфигурирайте MCP клиенти и създавайте начална структура на проекти от терминала.

CLI изисква Node.js 18.18 или по-нова версия. Стартирайте го с npx или го инсталирайте глобално:

npm install -g thunderphone
thunderphone --help

Влизане

npx thunderphone login
thunderphone whoami --json

Влизането извежда код за потвърждение, отваря браузъра и изчаква упълномощаване. Използвайте --no-browser на машина без графична среда и отворете изведения URL другаде. Влизането от устройство изисква внедряването на OAuth потока за устройства на API. API ключ на организация в THUNDERPHONE_API_KEY също може да удостоверява команди и има предимство пред запазените идентификационни данни за влизане.

Идентификационните данни се съхраняват по профили в ~/.config/thunderphone/credentials.json с файлов режим 0600. XDG_CONFIG_HOME и THUNDERPHONE_CONFIG_DIR заместват директорията. Токените за достъп се обновяват автоматично, а ротационните токени за обновяване се запазват атомарно. Токените никога не се извеждат при влизане.

thunderphone login --profile work
thunderphone agents list --profile work --json
thunderphone logout --profile work

THUNDERPHONE_PROFILE задава профила по подразбиране. Излизането премахва локалните идентификационни данни; то не отменя разрешението на сървъра. Промяната или нулирането на паролата ви или промяната на имейла на акаунта ви го отменя; изпълнете отново thunderphone login. API по подразбиране е https://api.thunderphone.com. Използвайте --api-base-url или THUNDERPHONE_API_BASE_URL за друг API. Токенът на даден профил не може да бъде изпратен към различен конфигуриран URL адрес на API; влезте в този URL адрес с отделен профил.

Команди

Всяка команда приема --json. Успешните данни се извеждат в stdout; грешките се извеждат в stderr с ненулев код за изход. Без --json изходът е компактна таблица или списък с полета. JSON запазва структурата на API отговора, като полетата за идентификационни данни са редактирани. MCP обслужването запазва stdout за MCP протокола.

КомандаПредназначение
login [--no-browser] [--scope "scopes"]Удостоверяване чрез код за устройство
logout, whoamiПремахване на локалните идентификационни данни; изброяване на достъпните организации
agents list, agents get IDПреглед на агенти
agents create --file agent.jsonСъздаване на агент
agents update ID --file agent.jsonЗаписване на чернова на агент
agents deploy ID, agents delete IDВнедряване на черновата; изтриване на агент
numbers listПреглед на телефонни номера
numbers provision --country US --area-code 415Осигуряване на входящ номер от САЩ
numbers assign NUMBER_ID --agent IDПрисвояване на входящ агент
sms send TO --from FROM --body TEXT --idempotency-key KEYИзпращане на SMS чрез номер на свързан с клиента оператор с безопасно повторно изпълнение
sms list [--limit N], sms get UUIDИзброяване или преглед на SMS записи
call TO --agent ID --from FROM [--wait]Извършване на изходящо обаждане; по избор изчакване на транскрипцията му
calls list [--limit N] [--agent ID]Изброяване на обаждания (лимит 1–200)
calls get ID, calls transcript IDПреглед на едно обаждане или транскрипцията му
test run AGENT_ID [--scenario ID] --consent-to-chargeИзпълнение на таксувани запазени сценарии чрез уеб канала
test status RUN_ID [--agent ID]Преглед на пакет със сведения за сценариите, когато е посочен агент
import VENDOR export.jsonПодготовка на JSON импорт от доставчик за преглед
imports get UUID, imports commit UUIDПреглед на импорт; потвърждаване на избраните агенти след преглед
mcp setup, mcp serveКонфигуриране на клиент; стартиране на stdio мост
init [directory]Създаване на начална структура на проект

Изходящите обаждания изискват номер с активирани изходящи обаждания. THUNDERPHONE_FROM_NUMBER може да предостави --from. Клиентските VoIP номера продължават да поддържат изходящи обаждания. Номерата, осигурени от ThunderPhone, първоначално са само за входящи обаждания; администратор на организацията може да заяви изходящи обаждания от страницата „Телефонни номера“, където всяка заявка се преглежда ръчно. --wait по подразбиране е с едночасово изчакване; задайте --timeout SECONDS, за да го промените. Изтичането на времето за изчакване спира чакането, без да прекратява обаждането.

SMS също изисква номер с възможност за SMS във Вашия свързан акаунт в Twilio или Telnyx. Никога не се изпраща от номер, притежаван от ThunderPhone. Използвайте повторно ключ за идемпотентност само когато повтаряте опит за изпращане със същия подател, получател и текст.

Импортите поддържат vapi, retell, elevenlabs и bland. Вторият аргумент е път към JSON експорт от доставчик, а не отдалечен идентификатор на доставчик. API подготвя съпоставяне асинхронно; прегледайте го с imports get UUID и потвърдете едва когато е готово и сте прегледали съпоставените полета и предупрежденията. Вижте импортиране на агенти.

Настройване на MCP

thunderphone mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
thunderphone mcp setup --client codex --scope user --api-key-env THUNDERPHONE_API_KEY
thunderphone mcp setup --client claude-desktop --scope user

Клиенти: claude-code, codex, cursor, vscode, gemini, claude-desktop и windsurf. Обхватът на проекта е по подразбиране. Desktop и Windsurf изискват потребителски обхват. Пропуснете --client, за да откриете един клиент от проекта; при нееднозначно откриване ще получите интерактивна подкана или командата ще завърши с инструкции в неинтерактивна сесия. Настройването извежда файла, който е записало, и запазва несвързаните сървъри. Съществуващият JSON трябва да е валиден строг JSON; TOML стойностите за Codex се запазват, но коментарите може да бъдат преформатирани.

Настройването предпочита директен отдалечен HTTP. С --api-key-env записва препратка към променлива, никога ключа. Без тази опция директният HTTP разчита на OAuth поддръжката на клиента; не използва файла с идентификационни данни на CLI. За да използвате повторно идентификационните данни от thunderphone login във всеки клиент с поддръжка на stdio, използвайте:

{
  "mcpServers": {
    "thunderphone": {
      "command": "npx",
      "args": ["-y", "@thunderphone/mcp"]
    }
  }
}

Обвивката проверява THUNDERPHONE_API_KEY, след това текущия CLI профил (като го обновява при нужда), след което делегира OAuth към mcp-remote. THUNDERPHONE_MCP_URL замества крайната точка. Не изпраща телеметрия. Самостоятелно настройване е налично и чрез npx -y @thunderphone/mcp setup --client cursor или thunderphone-mcp setup след глобално инсталиране на @thunderphone/mcp.

Създаване на проект

npx create-thunderphone-agent my-receptionist
npx create-thunderphone-agent my-outbound --template python --agent-type outbound
# Equivalent:
thunderphone init my-receptionist --template node --agent-type receptionist

Шаблоните са node и python; типовете агенти са receptionist, outbound и custom. Агентът по подразбиране е англо-испански стоматологичен рецепционист с изрично зададени демонстрационни факти. Проектите включват agent.json, скриптове за внедряване, MCP конфигурации за Claude Code, Cursor и VS Code, инструкции за агента, .env.example и README. Генерирането на структурата работи офлайн и отказва да презапише непразна директория.

Редактирайте бизнес фактите преди внедряване. Експортирайте API ключа, свързания номер на обаждащия се и получателя на тестовото обаждане, както е описано в генерирания README. npm run deploy или python deploy.py създава или актуализира агента, внедрява черновата му и извършва тестово обаждане, което се таксува. Скриптовете използват удостоверяване с API ключ; CLI и stdio MCP обвивката поддържат и влизане от устройство. Скриптовете за Python изискват Python 3.9 или по-нова версия.