OdyOdy
Subukan nang libre

Developer API

Ang iyong business phone,
ngayon ay programmable.

Bawat contact, pag-uusap, mensahe, at tawag sa iyong Ody workspace sa likod ng isang malinis na REST API | kasama ang isang MCP server para sa mga AI assistant, signed webhooks, at SDKs. Isang key, nagawa sa loob ng ilang minuto.

Bearer auth · ody_live_ at ody_test_ keys · Settings → Developer API

send-sms.sh | ang iyong unang API call
# Magpadala ng SMS mula sa iyong Ody number
curl https://api.ody.co/v1/api/messages \
-H "Authorization: Bearer ody_live_…" \
-H "Idempotency-Key: order-1042-shipped" \
-d '{"to": "+15125550123", "body": "Your order shipped!"}'
201 Nilikha
{
"conversationId": "b4a6f0…",
"message": { "body": "Your order shipped!" },
"simulated": false
}
Idempotency-Key sa POST /messages | ang mga pagsubok muli sa loob ng 24h ay nagre-replay ng unang tugon
Cursor pagination sa bawat list endpoint | sundin ang nextCursor, huwag kailanman palampasin ang isang row
Standard RateLimit-Limit / -Remaining / -Reset headers, Retry-After sa 429
Uniform JSON error envelope na may X-Request-Id echo sa bawat tugon

ANG PLATFORM

Lahat ng kailangan mo para bumuo sa Ody

Anim na bahagi, isang API key. Dinisenyo upang maging predictable sa pinakamagandang paraan: predictable na resources, predictable na errors, predictable na pages.

REST API

Contacts CRUD, mga pag-uusap, pagpapadala ng SMS/MMS, paghahanap ng mensahe, kasaysayan ng tawag, mga numero ng telepono, ang iyong AI agent, at ang knowledge base nito sa https://api.ody.co/v1/api | Bearer-authenticated gamit ang iyong ody_live_ key.

GET /v1/api/contacts

MCP para sa mga AI assistant

Ikonekta ang ChatGPT, Claude, o Cursor sa https://api.ody.co/v1/mcp at ang iyong assistant ay makakakuha ng 29 na tool | maglista at mag-update ng mga contact, magbasa ng mga pag-uusap, maghanap ng mga mensahe, magpadala ng mga text, i-configure ang AI agent, panatilihin ang knowledge base nito | naka-scope sa iyong key.

29 tools · /v1/mcp

Signed webhooks

Outbound webhooks na may Standard-Webhooks HMAC signing | webhook-id, webhook-timestamp, at webhook-signature headers | awtomatikong pagsubok muli, at per-endpoint secrets na maaari mong i-rotate anumang oras.

webhook-signature: v1,…

Test mode

Ang mga ody_test_ key ay kumikilos nang eksakto tulad ng mga live key, ngunit ang pagpapadala ng mensahe ay simulated | walang totoong SMS ang umaalis. Ituro ang iyong CI sa production at matulog nang mahimbing.

"simulated": true

TypeScript at Python SDKs

Opisyal, fully typed na mga client na may auto-pagination, typed errors, idempotent sends, at webhook signature verification na built-in | kaya hindi mo na kailangang manual na gumawa ng HMAC muli.

await ody.messages.send(…)

OpenAPI 3.1

Ang buong surface ay inilarawan sa isang machine-readable spec sa /v1/api/openapi.json | bumuo ng mga client, mock server, o ipasok lang ito sa iyong AI coding agent.

GET /v1/api/openapi.json

PINAKAMABABANG PRIBILIHIYO

Mga key na ginagawa lang ang sinasabi mo

Gumawa ng mga key sa Ody app sa ilalim ng Settings → Developer API at paliitin ang bawat isa sa eksaktong mga scope na kailangan ng isang integrasyon | labindalawang scope sa mga contact, pag-uusap, mensahe, numero, tawag, ang AI agent, kaalaman, at mga webhook. Ang isang read-only na dashboard key ay hindi kailanman makakapag-text sa isang customer.

ody_live_… · scoped key
✓contacts:read
✕contacts:write
✓conversations:read
✕conversations:write
✓messages:send
✓numbers:read
✓knowledge:read
✕knowledge:write
✕webhooks:manage

MODEL CONTEXT PROTOCOL

Idikit ang isang block, ang iyong AI ay nasa mga telepono

Ang parehong API key ang nagpapagana sa MCP server. Ilagay ang config na ito sa ChatGPT, Claude, o Cursor at hilingin sa iyong assistant na balikan ang mga hindi pa nababasang usapan, gumawa ng mga tugon, o mag-text ng customer | bawat tawag ay nakasaklaw sa kung ano ang pinapayagan ng key.

Galugarin ang MCP server→
mcp.json
{
"mcpServers": {
"ody": {
"url": "https://api.ody.co/v1/mcp",
"headers": {
"Authorization": "Bearer ody_live_…"
}
}
}
}

MAGSIMULANG BUMUO

Mula sa wala hanggang sa unang SMS sa loob ng limang minuto

Kumuha ng key, gumawa ng isang curl call, at nakapagpadala ka na ng text. Ang kumpletong API reference, webhook guides, at SDK quickstarts ay nasa dev.ody.co.

Ang mga API key ay ginagawa ng mga may-ari at admin ng workspace sa ilalim ng Settings → Developer API.

FAQ

Mga tanong ng developer, sinagot

Ano ang kayang gawin ng API ngayon?
Buong contacts CRUD; maglista at magbasa ng mga pag-uusap at itakda ang kanilang status; magpadala ng SMS at MMS; maghanap sa iyong kasaysayan ng mensahe; kumuha ng kasaysayan ng tawag at voicemail na may mga transcript; maglista, bumili, at mag-ruta ng iyong mga numero ng telepono; i-configure at i-publish ang AI agent; at magbasa, magsulat, maghanap, at mag-import sa knowledge base na pinagkukunan ng sagot ng bawat AI. Ang kumpletong reference ay nasa developer docs sa dev.ody.co.

Resources

Learn more

Guides to the concepts behind this feature.

What businesses need to know about CPaaSLearn how CPaaS APIs differ from UCaaS employee calling and CCaaS contact-center suites, and where SIP and WebRTC still sit underneath.Read guide What businesses need to know about MCPHow the Model Context Protocol standardizes the connection between AI assistants and external systems, and what an MCP server for a phone system exposes.Read guide What engineers need to know about SIPHow RFC 3261 signaling (INVITE, ACK, BYE) relates to SDP, RTP media, trunks, and registration.Read guide

Mas mahusay sa iyong stack

Ang API ang buong saklaw. Ang mga integrasyon ang no-code na landas.

Ang mga scoped key, webhook, at SDK ay sumasaklaw sa anumang nais mong buuin. Ang Slack, Make, at CSV ay sumasaklaw sa mga gawain na hindi na kailangang isulat ng karamihan sa mga team.

MakeAutomation

Isang scenario sa halip na isang webhook handler, kung sapat na iyon.

Mag-trigger ng Make scenario mula sa isang Ody call event. Gamitin ang API kapag kailangan mo ng idempotency, pagination, at sarili mong code. Gamitin ang Make kapag kailangan mo ng fan-out ngayon.

Scenario na tumakbo
MKon-call-completedExecution id ibinalik
No-code na fan-out
Tingnan ang Make integration→
SlackMga Abiso

Mga alerto sa channel nang hindi isinusulat ang Slack app.

OAuth, pumili ng channel, tapos na. Ang mga missed call, voicemail, at buod ay ipinopost doon. Gumawa ng sarili mo gamit ang mga webhook kapag kailangan mo ng ibang payload.

#front-desk
✦Hindi nasagot na tawag · Sophie TranOne-click na OAuth
Walang bot na kailangang i-maintain
Tingnan ang Slack integration→
CSV importPag-import ng Data

Isang contact import nang walang POST /contacts sa isang loop.

Mag-upload ng CSV kapag ang listahan ay nasa spreadsheet na. Gamitin ang contacts API kapag ang pinagmulan ng impormasyon ay ang sarili mong system.

Tapos na ang import
✓customers-2026.csvMga duplicate ay nilaktawan
Walang developer
Tingnan ang CSV import→
KlaviyoMarketing

Mga call event sa Klaviyo, nang walang custom job.

Magpadala ng call outcome bilang isang Klaviyo event upang mag-trigger ng mga flow. Buuin ang parehong bagay sa API kung kailangan mo ng ibang destinasyon.

Klaviyo event
STSophie TranCall outcome na na-track
Flows
Tingnan ang Klaviyo integration→
Tingnan ang lahat ng 43 integrasyon→

Huwag nang palampasin ang isa pang customer.

Ilipat ang iyong numero, sanayin ang iyong agent sa loob ng ilang minuto, at ilagay ang iyong linya sa autopilot. O panatilihing naka-off nang buo ang AI. Ikaw ang bahala.