Tumawag gamit ang AI at pamahalaan ang Astra sa pamamagitan ng API

Maaaring i-configure at i-publish ng API ang Astra (iyong AI agent), ikonekta ang isang numero dito, at hayaan itong tumawag palabas: Ang POST /v1/api/calls ay nagpapatawag sa iyong na-publish na agent sa isang numero, humahawak ng pag-uusap, at nagla-log ng tawag — kasama ang recording, transcript, at summary — sa timeline ng contact sa iyong inbox, na sinisingil sa AI credits tulad ng isang inbound AI-answered call.

Bago ka magsimula

• Kailangan ng iyong API key ang tamang scopes — mga chips sa Mga Setting → Developer API: Pamahalaan ang AI agent (agent:manage) para sa config ng agent at pagruruta ng numero, at Tumawag gamit ang AI (calls:place) para sa outbound calls. Kasama sa full-access keys ang pareho. Tingnan ang Kunin ang iyong Ody API key.
• Ang outbound calls ay nangangailangan ng isang aktibong plano, isang na-publish at naka-enable na agent, at hindi bababa sa isang aktibong numero sa iyong workspace.
• Gumagana ang credits tulad ng dati: 100 credits bawat AI-answered call, libre ang mga tawag na mas mababa sa 15 segundo, at bawat plano ay may kasamang 1,000 credits bawat buwan. Tingnan ang Astra credits at paggamit.

I-configure at i-publish ang iyong agent

Ang GET /v1/api/agent ay nagbabalik ng config ng agent kasama ang iyong kasalukuyang credit usage sa cycle — madaling gamitin para sa pagsuri ng budget bago ang isang batch ng tawag. Ina-update ito ng PATCH /v1/api/agent: name, greeting, tone, voice, language, timezone, inHoursAction/offHoursAction (agent, voicemail, app, o forward), enabled, at jobs. Tanging ang mga field na ipinapadala mo ang nagbabago, maliban sa jobs, na ganap na pinapalitan kapag ibinigay:

curl -X PATCH https://api.ody.co/v1/api/agent \
  -H "Authorization: Bearer ody_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Front Desk",
    "greeting": "Thanks for calling Acme Plumbing!",
    "tone": "Friendly",
    "jobs": [{"name": "Take a message", "instructions": "Collect the name, number, and reason for calling."}]
  }'

Ang mga pagbabago ay nai-save bilang isang draft — ang parehong draft na makikita mo sa screen ng AI agent sa app. I-publish ito nang live gamit ang:

curl -X POST https://api.ody.co/v1/api/agent/publish \
  -H "Authorization: Bearer ody_live_…"

Ikonekta ang isang numero sa agent

Ang POST /v1/api/numbers/{number}/connect ay nagruruta ng isa sa iyong mga numero sa agent upang masagot nito ang mga inbound calls (i-URL-encode ang + bilang %2B):

curl -X POST "https://api.ody.co/v1/api/numbers/%2B15125550123/connect" \
  -H "Authorization: Bearer ody_live_…"

Upang iruta ito pabalik sa iyong team, gamitin ang …/disconnect na may mode na app (i-ring ang iyong team — ang default), voicemail, o forward (na may forwardTo na numero):

curl -X POST "https://api.ody.co/v1/api/numbers/%2B15125550123/disconnect" \
  -H "Authorization: Bearer ody_live_…" \
  -H "Content-Type: application/json" \
  -d '{"mode":"app"}'

Tumawag palabas gamit ang AI

Ang POST /v1/api/calls ay nagpapatawag sa iyong na-publish na agent palabas at humahawak ng pag-uusap:

curl https://api.ody.co/v1/api/calls \
  -H "Authorization: Bearer ody_live_…" \
  -H "Content-Type: application/json" \
  -d '{"to":"+15125550199"}'

• Kinakailangan ang to (E.164). Opsyonal ang from — mas gusto ng Ody ang iyong agent-connected number, pagkatapos ay ang iyong unang aktibong numero; ipasa ang from upang pumili ng isang partikular na linya na pagmamay-ari mo.
• Ang mga international destination ay sumusunod sa karaniwang mga panuntunan sa international calling ng iyong workspace — tingnan ang International calling at mga limitasyon.
• Kapag natapos ang tawag, lumalabas ito sa timeline ng contact sa iyong inbox na may recording, transcript, at summary — ang parehong card na "AI agent ang humawak sa tawag na ito" tulad ng isang inbound AI call.
• Pagsingil: 100 credits kapag nasagot ang tawag, libre sa ilalim ng 15 segundo — at ang tawag na hindi nasagot ay palaging libre.

Maaari kang pumalit anumang oras

Anumang ginawa sa pamamagitan ng API ay ang iyong tunay na estado ng account — hindi isang hiwalay na developer sandbox. Ang agent na inilalathala ng iyong code ay ang nasa screen ng AI agent; ang numerong konektado nito ay nasa Mga Setting → Mga Numero; ang mga tawag na inilalagay nito ay napupunta sa iyong shared inbox. Nangangahulugan iyon na maaari kang sumali anumang oras: i-edit ang pagbati sa app, sumagot sa isang thread nang ikaw mismo, o i-click ang mga routing chips ng isang numero upang ibalik ang mga tawag sa iyong team — walang API na kasama.

Mula sa isang AI assistant (MCP)

Ang mga konektadong AI assistant ay nakakakuha ng parehong kapangarihan tulad ng mga tool ng MCP: get_agent, configure_agent (ipasa ang publish: true upang maging live sa isang hakbang), connect_agent_to_number, at place_call. Tingnan ang Ikonekta ang mga tool ng AI sa MCP.

Test mode

Gamit ang isang ody_test_… key, ang POST /calls ay nagbabalik ng isang simulated call (isang sim_… id, walang tinawagan, walang ginamit na credits) at ang POST /agent/publish ay simulated (ang iyong config ay nananatiling draft). Ang mga draft save sa pamamagitan ng PATCH /agent ay totoo sa parehong uri ng key. Tingnan ang Bumuo nang ligtas gamit ang test mode.

Mga kaugnay na artikulo

• Kilalanin si Astra, ang iyong AI receptionist
• Astra credits at paggamit
• Bumili ng mga numero at magrehistro ng texting sa pamamagitan ng API
• Ikonekta ang mga tool ng AI sa MCP