Ses API

Era’larınız telefonu ve web sitenizi sesle yanıtlar, randevu verir, mesaj alır ve her aramayı Gelen kutusuna kaydeder.

Modül kodu voice · 22 işlem · 3 veri modeli · 13 olay. Bir anahtar ya da token, arkasındaki kişinin bu modülde yapabildiğinden fazlasını asla yapamaz; satır düzeyindeki güvenlik uygulamadakiyle birebir aynıdır. Yetki kapsamları: voice (hepsi), voice:read (yalnız okuma) ya da voice:<yetenek>.

Kaynaklar

Listeler limit (en çok 200), cursor, order (ör. -created_at), fields ve q alır; diğer her sorgu parametresi bir sütun süzgecidir: ?status=paid, ?total[gte]=100, ?id[in]=a,b, ?x=null.

İşlemler

voice.answer_permission

Müşteri arama iznini yanıtladı — İzin verdi: arama hemen yapılır. Vermedi: arama iptal olur, ücret alınmaz. Yalnız sistem.

Gereken izin voice:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/voice.answer_permission

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.call_missed

Neye yazar: voice_call (update) — awaiting → queued (allowed) or cancelled (declined, released)

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_awaiting · 429 çok sık istek

voice.await_permission

Müşterinin arama iznini bekle — WhatsApp, işletmenin yalnızca izin veren kişiyi aramasına izin verir: istek gitti, arama yanıtı bekliyor. Yalnız sistem.

Gereken izin voice:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/voice.await_permission

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: voice_call (update) — queued → awaiting permission

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_queued · 429 çok sık istek

voice.complete_call

Biten aramayı kaydet — Döküm, özet, sonuç ve süreyi yazar, gerçek dakikaları kendi ses anahtarına ölçer ve iş akışlarına haber verir. Yalnızca sistem.

Gereken izin voice:handle · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/voice.complete_call

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.call_finished, voice.appointment_booked, voice.lead_captured, voice.message_taken, voice.transfer_requested, voice.whatsapp_call_finished

Neye yazar: voice_call (update) — → completed, with transcript, outcome and cost

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 call_not_found, call_finished · 429 çok sık istek

voice.connect_whatsapp

WhatsApp aramalarını yanıtla — Era, WhatsApp Business numarana gelen sesli aramaları da yanıtlar ve her aramayı o müşterinin WhatsApp sohbetine kaydeder.

Gereken izin voice:manage · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/voice.connect_whatsapp

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.agent_changed

Neye yazar: voice_agent (update) — Points the WhatsApp line at the Era (pending until Meta and the voice provider take it)

curl -X POST https://app.getera.io/api/v1/voice_agents/VOICE_AGENT_ID/actions/connect_whatsapp \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"inboxId":"INBOX_ID"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "voice.agent_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.voiceAgents.connectWhatsapp("VOICE_AGENT_ID", {
  inboxId: "INBOX_ID"
})

era voice_agents connect_whatsapp VOICE_AGENT_ID \
  --inbox-id "INBOX_ID"

{
  "name": "era__voice__connect_whatsapp",
  "arguments": {
    "id": "VOICE_AGENT_ID",
    "inboxId": "INBOX_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 voice_not_found, inbox_not_whatsapp, whatsapp_taken · 429 çok sık istek

voice.connect_whatsapp_call

Era bir WhatsApp aramasını açtı — Bilgisayar WhatsApp aramasını açtı (ya da yaptı) ve ses bağlandı — dakikalar ve ödeme önce kontrol edilir. Yalnızca sistem.

Gereken izin voice:handle · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/voice.connect_whatsapp_call

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.call_started

Neye yazar: voice_call (update) — queued → in progress, with its reservation

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_ringing, wrong_computer, voice_not_found, voice_off, minutes_used_up, no_source, budget_exceeded · 429 çok sık istek

voice.decide_whatsapp_call

Çalan WhatsApp aramasını Era açsın ya da çalsın — Bilgisayarında bir WhatsApp araması çalarken: Era açar ya da senin için çalmaya devam eder. “WhatsApp araması çalıyor” iş akışları da bunu kullanır.

Gereken izin voice:write · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/voice.decide_whatsapp_call

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: voice_call (update) — Writes the decision; a call left to ring is closed without cost

curl -X POST https://app.getera.io/api/v1/voice_calls/VOICE_CALL_ID/actions/decide_whatsapp_call \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"answer":true}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.voiceCalls.decideWhatsappCall("VOICE_CALL_ID", {
  answer: true
})

era voice_calls decide_whatsapp_call VOICE_CALL_ID \
  --answer true

{
  "name": "era__voice__decide_whatsapp_call",
  "arguments": {
    "id": "VOICE_CALL_ID",
    "answer": true
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_ringing · 429 çok sık istek

voice.enable

Bir Era’ya ses ver — Bir Era telefonunu, web sitesindeki ses butonunu ve uygulamada seni yanıtlar — seçtiğin ses, karşılama, saatler ve yeteneklerle.

Gereken izin voice:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/voice.enable

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.agent_changed

Neye yazar: voice_agent (insert) — Writes the voice, switched off until it is ready

curl -X POST https://app.getera.io/api/v1/voice_agents/actions/enable \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"agentId":"AI_AGENT_ID","inboxId":"INBOX_ID"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "voice.agent_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.voiceAgents.enable({
  agentId: "AI_AGENT_ID",
  inboxId: "INBOX_ID"
})

era voice_agents enable \
  --agent-id "AI_AGENT_ID" \
  --inbox-id "INBOX_ID"

{
  "name": "era__voice__enable",
  "arguments": {
    "agentId": "AI_AGENT_ID",
    "inboxId": "INBOX_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 agent_not_found, already_has_voice, inbox_not_voice, inbox_taken, unknown_tool, bad_transfer_number, transfer_needs_number, unknown_language, unknown_knowledge_base, site_not_found · 429 çok sık istek

voice.fail_call

Arama gerçekleşmedi — Meşgul, cevap yok ya da başarısız: hiçbir şey ölçülmez, cevapsız arama takip edilebilir. Yalnızca sistem.

Gereken izin voice:handle · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/voice.fail_call

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.call_missed

Neye yazar: voice_call (update) — → missed / failed / cancelled, released

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 call_finished, invalid_state · 429 çok sık istek

voice.mark_dialed

Arama yapıldı — Sağlayıcı numarayı çaldırıyor. Yalnızca sistem.

Gereken izin voice:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/voice.mark_dialed

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: voice_call (update) — queued → in progress

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_queued · 429 çok sık istek

voice.open_call

Bir arama başladı — Arama başladığı anda kaydedilir — telefon, web butonu ya da uygulama — dakika ve para kontrolünden sonra. Yalnızca sistem.

Gereken izin voice:handle · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/voice.open_call

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.call_started

Neye yazar: voice_call (insert) — Opens the call

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 voice_not_found, voice_off, channel_off, unknown_bridge, minutes_used_up, no_source, budget_exceeded · 429 çok sık istek

voice.record_sync

Ses sağlayıcısının yanıtını kaydet — Sağlayıcı Era’nın sesini ve numarasını aldı (ya da reddetti). Yalnızca sistem.

Gereken izin voice:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/voice.record_sync

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.sync_failed

Neye yazar: voice_agent (update) — Writes the provider ids and the sync state

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 voice_not_found, invalid_state · 429 çok sık istek

voice.record_turn

Era’nın aramada yaptığını kaydet — Bir yanıtın işlemlerini arama günlüğüne ekler ve kısa hafızasını tutar. Yalnızca sistem.

Gereken izin voice:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/voice.record_turn

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: voice_call (update) — Appends actions, replaces memory

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 call_not_open · 429 çok sık istek

voice.record_whatsapp

WhatsApp aramalarının durumunu kaydet — Meta ve ses sağlayıcısı kurulumu aldı ya da reddetti. Yalnız sistem.

Gereken izin voice:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/voice.record_whatsapp

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.sync_failed

Neye yazar: voice_agent (update) — Writes the WhatsApp line state and the provider number id

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 voice_not_found, invalid_state · 429 çok sık istek

voice.remove

Era’nın sesini kaldır — Era aramaları yanıtlamayı bırakır. Arama geçmişi kalır.

Gereken izin voice:delete · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/voice.remove

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.agent_changed

Neye yazar: voice_agent (delete) — Deletes the voice; calls keep their history

curl -X POST https://app.getera.io/api/v1/voice_agents/VOICE_AGENT_ID/actions/remove \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "voice.agent_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.voiceAgents.remove("VOICE_AGENT_ID")

era voice_agents remove VOICE_AGENT_ID

{
  "name": "era__voice__remove",
  "arguments": {
    "id": "VOICE_AGENT_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:delete izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 voice_not_found · 429 çok sık istek

voice.set_enabled

Era’nın sesini aç/kapat — Açık: aramaları yanıtlar. Kapalı: Era yanıtlamaz; hiçbir şey kaybolmaz.

Gereken izin voice:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/voice.set_enabled

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.agent_changed

Neye yazar: voice_agent (update) — Flips the switch

curl -X POST https://app.getera.io/api/v1/voice_agents/VOICE_AGENT_ID/actions/set_enabled \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"enabled":true}'

{
  "ok": true,
  "result": "…",
  "events": [
    "voice.agent_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.voiceAgents.setEnabled("VOICE_AGENT_ID", {
  enabled: true
})

era voice_agents set_enabled VOICE_AGENT_ID \
  --enabled true

{
  "name": "era__voice__set_enabled",
  "arguments": {
    "id": "VOICE_AGENT_ID",
    "enabled": true
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 voice_not_found, no_voice, inbox_not_voice · 429 çok sık istek

voice.set_outcome

Aramanın sonucunu düzelt — Era aramayı yanlış okuduysa — aslında randevuydu, potansiyel müşteriydi, mesajdı.

Gereken izin voice:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/voice.set_outcome

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: voice_call (update) — Writes the outcome

curl -X POST https://app.getera.io/api/v1/voice_calls/VOICE_CALL_ID/actions/set_outcome \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"outcome":"booked"}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.voiceCalls.setOutcome("VOICE_CALL_ID", {
  outcome: "booked"
})

era voice_calls set_outcome VOICE_CALL_ID \
  --outcome "booked"

{
  "name": "era__voice__set_outcome",
  "arguments": {
    "id": "VOICE_CALL_ID",
    "outcome": "booked"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 call_not_finished · 429 çok sık istek

voice.set_whatsapp_line

WhatsApp aramalarını bilgisayarımda aç — Era bilgisayarındaki WhatsApp’a gelen sesli aramaları açar — hangileri, kaç saniye sonra ve senin yerine arama yapıp yapamayacağı. Telefon numarası gerekmez.

Gereken izin voice:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/voice.set_whatsapp_line

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: voice_whatsapp_line (upsert) — Writes the workspace’s one WhatsApp-on-the-computer line

curl -X POST https://app.getera.io/api/v1/voice_whatsapp_lines/actions/set_whatsapp_line \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"voiceAgentId":"VOICE_AGENT_ID"}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.voiceWhatsappLines.setWhatsappLine({
  voiceAgentId: "VOICE_AGENT_ID"
})

era voice_whatsapp_lines set_whatsapp_line \
  --voice-agent-id "VOICE_AGENT_ID"

{
  "name": "era__voice__set_whatsapp_line",
  "arguments": {
    "voiceAgentId": "VOICE_AGENT_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 voice_not_found · 429 çok sık istek

voice.start_call

Ara (sesli ajanla) — Era bir müşteriyi şimdi arar — telefonla ya da WhatsApp’tan (gerekirse önce müşteriden izin ister): randevu teyidi, potansiyel müşteri takibi, siparişin hazır olduğu. Dakikalar önce kontrol edilip ayrılır.

Gereken izin voice:write · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır) · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/voice.start_call

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.call_started

Neye yazar: voice_call (insert) — Queues the call

curl -X POST https://app.getera.io/api/v1/voice_calls/actions/start_call \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"voiceAgentId":"VOICE_AGENT_ID","to":"Number"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "voice.call_started"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.voiceCalls.startCall({
  voiceAgentId: "VOICE_AGENT_ID",
  to: "Number"
})

era voice_calls start_call \
  --voice-agent-id "VOICE_AGENT_ID" \
  --to "Number"

{
  "name": "era__voice__start_call",
  "arguments": {
    "voiceAgentId": "VOICE_AGENT_ID",
    "to": "Number"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 voice_not_found, voice_off, outbound_off, bad_number, no_phone_line, whatsapp_calling_off, minutes_used_up, outbound_limit, no_source, budget_exceeded · 429 çok sık istek

voice.start_whatsapp_call

WhatsApp’tan ara (sesli ajan ile) — Era bilgisayarındaki WhatsApp’tan birini arar, istediğin konuyu konuşur, kapatır ve nasıl geçtiğini anlatır — özet, sonuç, konuşma metni.

Gereken izin voice:write · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/voice.start_whatsapp_call

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.whatsapp_call_requested

Neye yazar: voice_call (insert) — Queues the call for the computer, with its reservation

curl -X POST https://app.getera.io/api/v1/voice_calls/actions/start_whatsapp_call \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"goal":"What to talk about"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "voice.whatsapp_call_requested"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.voiceCalls.startWhatsappCall({
  goal: "What to talk about"
})

era voice_calls start_whatsapp_call \
  --goal "What to talk about"

{
  "name": "era__voice__start_whatsapp_call",
  "arguments": {
    "goal": "What to talk about"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 whatsapp_line_off, whatsapp_outbound_off, no_one_to_call, bad_number, voice_not_found, voice_off, minutes_used_up, outbound_limit, no_source, budget_exceeded · 429 çok sık istek

voice.take_over_whatsapp_call

WhatsApp aramasını Era’dan devral — “Devral”: Era susar ve aramanın sesi bilgisayardaki kendi mikrofonuna ve hoparlörüne döner.

Gereken izin voice:write · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/voice.take_over_whatsapp_call

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.whatsapp_takeover

Neye yazar: voice_call (update) — Marks the moment; the computer hands the sound back

curl -X POST https://app.getera.io/api/v1/voice_calls/VOICE_CALL_ID/actions/take_over_whatsapp_call \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "voice.whatsapp_takeover"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.voiceCalls.takeOverWhatsappCall("VOICE_CALL_ID")

era voice_calls take_over_whatsapp_call VOICE_CALL_ID

{
  "name": "era__voice__take_over_whatsapp_call",
  "arguments": {
    "id": "VOICE_CALL_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 call_not_live · 429 çok sık istek

voice.update

Era’nın sesini değiştir — Ses, karşılama, dil, çalışma saatleri dışı davranış, aktarma numarası, yetenekler, bilgi ve nerede cevap verdiği.

Gereken izin voice:manage · veriyi değiştirir

• REST kısayolu: PATCH /api/v1/voice_agents/{id}
• Asıl adres: POST /api/v1/actions/voice.update

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.agent_changed

Neye yazar: voice_agent (update) — Writes the settings and marks the provider copy for re-sync

curl -X POST https://app.getera.io/api/v1/voice_agents/VOICE_AGENT_ID/actions/update \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"inboxId":"INBOX_ID"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "voice.agent_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.voiceAgents.update("VOICE_AGENT_ID", {
  inboxId: "INBOX_ID"
})

era voice_agents update VOICE_AGENT_ID \
  --inbox-id "INBOX_ID"

{
  "name": "era__voice__update",
  "arguments": {
    "id": "VOICE_AGENT_ID",
    "inboxId": "INBOX_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 voice_not_found, inbox_not_voice, inbox_taken, unknown_tool, bad_transfer_number, transfer_needs_number, unknown_language, unknown_knowledge_base, site_not_found · 429 çok sık istek

voice.whatsapp_ring

Bilgisayarda bir WhatsApp araması çalıyor — Era Desktop çalan bir WhatsApp aramasını bildirir; kural Era’nın açacağını, sana bırakacağını ya da bir iş akışının karar vereceğini söyler. Yalnızca sistem.

Gereken izin voice:handle · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/voice.whatsapp_ring

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: voice.whatsapp_ringing

Neye yazar: voice_call (insert) — A ringing WhatsApp call with Era’s decision

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde voice:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 whatsapp_line_off, wrong_computer, voice_not_found, voice_off · 429 çok sık istek

Veri modelleri

VoiceAgent

Tablo voice_agent · Kaynak voice_agents

• GET /api/v1/voice_agents
• GET /api/v1/voice_agents/{id}
• PATCH /api/v1/voice_agents/{id} → voice.update

Birincil anahtar: id

Denetimler:

• CHECK (((after_hours_message IS NULL) OR (length(after_hours_message) <= 600)))
• CHECK ((approval_tools <@ tools))
• CHECK ((length(greeting) <= 600))
• CHECK ((language ~ '^[a-z]{2}(-[A-Z]{2})?$'::text))
• CHECK (((max_call_minutes >= 1) AND (max_call_minutes <= 60)))
• CHECK ((payer = 'own_key'::text))
• CHECK ((length(persona) <= 4000))
• CHECK (((sync_error IS NULL) OR (length(sync_error) <= 600)))
• CHECK ((tools <@ ARRAY['check_availability'::text, 'book_appointment'::text, 'cancel_appointment'::text, 'order_status'::text, 'capture_lead'::text, 'answer_question'::text, 'take_message'::text, 'transfer_to_human'::text]))
• CHECK (((transfer_number IS NULL) OR (transfer_number ~ '^\+[1-9][0-9]{6,14}$'::text)))
• CHECK (((whatsapp_error IS NULL) OR (length(whatsapp_error) <= 600)))
• CHECK (((widget_label IS NULL) OR (length(widget_label) <= 60)))

VoiceCall

Tablo voice_call · Kaynak voice_calls

• GET /api/v1/voice_calls
• GET /api/v1/voice_calls/{id}

Birincil anahtar: id

Denetimler:

• CHECK ((jsonb_typeof(actions) = 'array'::text))
• CHECK (((bridge IS NULL) OR (bridge = ANY (ARRAY['twilio'::text, 'sip'::text, 'elevenlabs'::text, 'whatsapp_sip'::text, 'desktop'::text, 'web'::text]))))
• CHECK ((duration_sec >= 0))
• CHECK (((error IS NULL) OR (length(error) <= 600)))
• CHECK ((jsonb_typeof(memory) = 'object'::text))
• CHECK (((outcome IS NULL) OR (outcome = ANY (ARRAY['booked'::text, 'cancelled'::text, 'lead'::text, 'message'::text, 'answered'::text, 'transferred'::text, 'no_action'::text, 'failed'::text]))))
• CHECK (((payer IS NULL) OR (payer = 'own_key'::text))) NOT VALID
• CHECK (((purpose IS NULL) OR (length(purpose) <= 1000)))
• CHECK (((ring_decision IS NULL) OR (ring_decision = ANY (ARRAY['answer'::text, 'ignore'::text, 'wait'::text]))))
• CHECK (((ring_reason IS NULL) OR (length(ring_reason) <= 300)))
• CHECK (((source_kind IS NULL) OR (source_kind = ANY (ARRAY['native'::text, 'byos'::text, 'byok'::text])))) NOT VALID
• CHECK ((jsonb_typeof(transcript) = 'array'::text))

VoiceWhatsappLine

Tablo voice_whatsapp_line · Kaynak voice_whatsapp_lines

• GET /api/v1/voice_whatsapp_lines
• GET /api/v1/voice_whatsapp_lines/{id}

Birincil anahtar: id

Denetimler:

• CHECK (((owner_name IS NULL) OR (length(owner_name) <= 120)))
• CHECK (((ring_seconds >= 0) AND (ring_seconds <= 40)))

Olaylar

İş akışları ve webhook'lar bu olaylara tepki verir.