Bumili ng mga numero at magparehistro ng pagte-text sa pamamagitan ng API

Ang API ay maaaring maghanap ng mga nabibiling numero ng telepono, bilhin ang mga ito, at irehistro ang iyong negosyo para sa 10DLC texting — na may eksaktong parehong billing, mga kinakailangan, at resulta tulad ng paggawa nito sa app. Ang isang numerong binili sa POST /v1/api/numbers ay agad na lumalabas sa Mga Setting → Mga Numero, at ang isang registration na na-file sa pamamagitan ng API ay lumalabas sa card ng Pag-setup ng pagte-text, kaya maaari kang pumasok at pamahalaan ang alinman sa app anumang oras.

Bago ka magsimula

• Ang iyong API key ay nangangailangan ng numbers:manage scope — ang chip na Bumili ng mga numero at 10DLC sa Mga Setting → Developer API. Awtomatikong kasama ito sa mga full-access key. Tingnan ang Kunin ang iyong Ody API key.
• Nalalapat ang parehong mga panuntunan tulad ng sa app: ang iyong workspace ay nangangailangan ng isang aktibong plano upang makabili, at kung hiniling sa iyo ng Ody na i-verify ang iyong pagkakakilanlan, dapat itong makumpleto muna — ibinabalik ng API ang 409 failed_precondition hanggang sa ito ay matapos.
• Ang billing ay kapareho ng sa in-app: kasama sa iyong plano ang isang numero, at bawat karagdagang numero ay sinisingil bilang $5/buwan na add-on para sa karagdagang numero. Tingnan ang Magdagdag ng mga karagdagang numero.

Maghanap ng mga available na numero

GET /v1/api/numbers/available ay naghahanap ng mga numerong mabibili mo. I-filter gamit ang country (default US), startsWith (hal. isang area code), contains, locality, state, at limit (default 20, max 50):

curl "https://api.ody.co/v1/api/numbers/available?startsWith=512&limit=5" \
  -H "Authorization: Bearer ody_live_…"

Bawat kandidato ay naglalaman ng numero nito at ang buwanang presyo na aktwal mong babayaran sa Ody:

{
  "available": [
    {
      "phone_number": "+15125550123",
      "cost_information": { "monthly_cost": "5.00", "upfront_cost": "0.00", "currency": "USD" }
    }
  ]
}

Bumili ng numero

POST /v1/api/numbers ay nag-o-order ng numero mula sa mga resulta ng paghahanap. Magpadala ng Idempotency-Key header upang ang isang network retry ay hindi makabili ng numero nang dalawang beses — ang isang retry sa loob ng 24 na oras ay nagre-replay ng orihinal na tugon na may Idempotency-Replayed: true header:

curl https://api.ody.co/v1/api/numbers \
  -H "Authorization: Bearer ody_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: onboarding-main-line" \
  -d '{"phoneNumber":"+15125550123"}'

Ang numero ay ini-order, idinagdag sa iyong workspace, at sinisingil sa iyong kasalukuyang subscription — eksaktong tulad ng pag-click sa Bumili sa app. Lumalabas ito sa Mga Setting → Mga Numero kaagad, kung saan ikaw (o ang iyong koponan) ay maaaring mag-configure ng ring order, voicemail, isang phone menu, o ang AI agent, tulad ng anumang iba pang numero. Gumagana agad ang mga tawag; ang pagte-text mula sa isang lokal na numero ay nakasarado hanggang sa maaprubahan ang 10DLC registration (sa ibaba).

Magparehistro para sa pagte-text (10DLC)

Kinakailangan ng mga US carrier ang pagpaparehistro ng negosyo bago makapagpadala ng mga text ang isang lokal na numero — sinasalamin ng API ang in-app na Pag-setup ng pagte-text na daloy.

Suriin ang status gamit ang GET /v1/api/messaging. Ang step ng tugon ay nagpapakita ng business (brand) review at pagkatapos ay campaign review, at ang canText ay nagiging true sa sandaling aprubahan ng mga carrier — gumagana na ang pagte-text sa lahat ng dako, sa app at sa API.

Isumite ang iyong registration gamit ang POST /v1/api/messaging/registration. Ang business block ay nangangailangan ng displayName, email, vertical, street, city, state, at postalCode — kasama ang iyong legal na companyName at EIN, maliban kung magparehistro ka bilang isang sole proprietor (entityType: "SOLE_PROPRIETOR" na may firstName, lastName, at isang contact phone sa halip). Ang campaign block ay opsyonal; ang mga makatuwirang default (isang Mixed use case na may compliant na paghawak ng STOP/HELP) ay inilalapat:

curl https://api.ody.co/v1/api/messaging/registration \
  -H "Authorization: Bearer ody_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "business": {
      "displayName": "Acme Plumbing",
      "email": "[email protected]",
      "vertical": "PROFESSIONAL",
      "companyName": "Acme Plumbing LLC",
      "ein": "12-3456789",
      "street": "600 Congress Ave",
      "city": "Austin",
      "state": "TX",
      "postalCode": "78701"
    },
    "campaign": {
      "description": "Customer care and appointment notifications",
      "samples": ["Acme Plumbing: your appointment is confirmed for Tuesday at 9am."]
    }
  }'

Ang isang pag-file sa pamamagitan ng API ay sinisingil eksaktong tulad ng isang in-app na pag-file, kasama ang $20 na one-time registration fee. Gamitin ang POST /v1/api/messaging/refresh upang muling suriin ang carrier review at isulong ang pipeline; awtomatiko ring umuusad ang pag-apruba.

Mula sa isang AI assistant (MCP)

Ang parehong mga kakayahan ay available bilang mga MCP tool, kaya ang isang konektadong assistant ay maaaring patakbuhin ang buong daloy na ito para sa iyo: search_numbers, buy_number, get_messaging_status, at submit_10dlc_registration. Tingnan ang Ikonekta ang mga AI tool sa MCP.

Test mode

Gamit ang ody_test_… key, ang POST /numbers ay nagbabalik ng simulated na pagbili ("simulated": true) — walang ini-order, inilalaan, o sinisingil — at ang mga 10DLC registration ay nagfa-file sa mock mode: ang buong pipeline ay tumatakbo nang walang registry submission at walang bayad. Tingnan ang Bumuo nang ligtas gamit ang test mode.

Mga kaugnay na artikulo

• Bumili ng numero ng telepono
• Magparehistro para sa 10DLC messaging
• Tumawag gamit ang AI at pamahalaan ang Astra sa pamamagitan ng API
• Bumuo nang ligtas gamit ang test mode