Open in
telephony.incoming / web.incoming
ಒಳಬರುವ ಕರೆಯ ಕಾನ್ಫಿಗರೇಶನ್ ಅನ್ನು ನೈಜ ಸಮಯದಲ್ಲಿ ರೂಪಿಸುವ ಬ್ಲಾಕಿಂಗ್ ವೆಬಹುಕ್.
ಒಳಬರುವ ಫೋನ್ ಕರೆ ನಿಯೋಜಿತ
ಏಜೆಂಟ್ ಇಲ್ಲದ ಸಂಖ್ಯೆಯನ್ನು ತಲುಪಿದಾಗ (ನಿಮ್ಮ ಹೊರಹೋಗುವ ಕರೆಗಳಿಗೆ ಮರಳಿ
ಕರೆ ಮಾಡುವವರಿಗಾಗಿ ಮರಳಿಕರೆಗಳು ನೋಡಿ), ಅಥವಾ ಪ್ರಕಟಿಸಬಹುದಾದ ಕೀಯಲ್ಲಿ ವೆಬ್ ವಿಜೆಟ್ ಸೆಷನ್
mode="webhook" ನಲ್ಲಿ ಪ್ರಾರಂಭವಾದಾಗ, ThunderPhone ನಿಮ್ಮ
ಹಳೆಯ ವೆಬ್ಹುಕ್ URL ಗೆ ತಡೆಹಿಡಿಯುವ
telephony.incoming / web.incoming ವಿನಂತಿಯನ್ನು ಕಳುಹಿಸಿ
ಸಂರಚನಾ ಪ್ರತಿಕ್ರಿಯೆಗಾಗಿ ಕಾಯುತ್ತದೆ: ಫೋನ್ ಕರೆಗೆ 13 ಸೆಕೆಂಡುಗಳವರೆಗೆ,
ಒಂದು ಮರುಪ್ರಯತ್ನ ಸೇರಿದಂತೆ, ಮತ್ತು ವಿಜೆಟ್ ಸೆಷನ್ಗೆ 10 ಸೆಕೆಂಡುಗಳವರೆಗೆ
(ಕಾಲಾವಧಿ ಮಿತಿಗಳು ಮತ್ತು ಮರುಪ್ರಯತ್ನಗಳು ನೋಡಿ). ಪ್ರತಿ ಕರೆಗೆ prompt, ಧ್ವನಿ ಮತ್ತು
ಉಪಕರಣಗಳನ್ನು ಕ್ರಿಯಾತ್ಮಕವಾಗಿ ಆಯ್ಕೆ ಮಾಡಲು ಈ ವಿನಿಮಯವನ್ನು ಬಳಸಿ —
ಸಂಪೂರ್ಣ ಮಾದರಿಗಾಗಿ ಕ್ರಿಯಾತ್ಮಕ ಕರೆ ಸಂರಚನಾ ಮಾರ್ಗದರ್ಶಿ
ನೋಡಿ.
ನಿಯೋಜಿತ ಏಜೆಂಟ್ ಹೊಂದಿರುವ ಸಂಖ್ಯೆಗೆ ಆ ಏಜೆಂಟ್ ಉತ್ತರಿಸುತ್ತಾನೆ. ಏಜೆಂಟ್ ತನ್ನದೇ ಆದ ಕರೆ ಸಿದ್ಧತಾ ವೆಬ್ಹುಕ್ ಹೊಂದಿದ್ದಾಗ, ಏಜೆಂಟ್ನ ವೇರಿಯಬಲ್ಗಳು ಮತ್ತು ಕರೆಯ ಸಂದರ್ಭವನ್ನು ಭರ್ತಿಮಾಡಲು ಅದೇ ತಡೆಯುವ ವಿನಿಮಯವು ಮೊದಲು ಏಜೆಂಟ್ನ URL ನಲ್ಲಿ ನಡೆಯುತ್ತದೆ.
ಕಾಲಮಿತಿಗಳು ಮತ್ತು ಮರುಪ್ರಯತ್ನಗಳು
ತ್ವರಿತವಾಗಿ ಪ್ರತಿಕ್ರಿಯಿಸಿ: ನೀವು ನಿರ್ಧರಿಸುವಾಗ ಕರೆಗಾರರು ಕರೆಯಲ್ಲೇ ಕಾಯುತ್ತಿದ್ದಾರೆ.
ಫೋನ್ ಕರೆಗಾಗಿ (telephony.incoming):
- ಮೊದಲ ಪ್ರಯತ್ನಕ್ಕೆ ಗರಿಷ್ಠ 10 ಸೆಕೆಂಡುಗಳು ಬೇಕಾಗಬಹುದು.
- ಸಮಯ ಮೀರಿದರೆ, ಸಂಪರ್ಕಿಸಲಾಗದಿದ್ದರೆ, ಅಥವಾ
5xx,408ಅಥವಾ429ಪ್ರತಿಕ್ರಿಯೆ ದೊರೆತರೆ, ThunderPhone ಮತ್ತೊಮ್ಮೆ ಪ್ರಯತ್ನಿಸುತ್ತದೆ. ಮರುಪ್ರಯತ್ನಕ್ಕೆ ಸಂಪೂರ್ಣ ವಿನಿಮಯಕ್ಕಾಗಿ ಇರುವ 13-ಸೆಕೆಂಡಿನ ಸಮಯಮಿತಿಯಲ್ಲಿ ಉಳಿದ ಸಮಯ ಲಭ್ಯವಾಗುತ್ತದೆ: ಸಮಯ ಮೀರಿದ ಮೊದಲ ಪ್ರಯತ್ನದ ನಂತರ ಸುಮಾರು 3 ಸೆಕೆಂಡುಗಳು, ವೇಗದ ವೈಫಲ್ಯದ ನಂತರ ಬಹುತೇಕ ಸಂಪೂರ್ಣ 13 ಸೆಕೆಂಡುಗಳು. 2 ಸೆಕೆಂಡುಗಳಿಗಿಂತ ಕಡಿಮೆ ಸಮಯ ಉಳಿದಿದ್ದರೆ ಮರುಪ್ರಯತ್ನ ಇರುವುದಿಲ್ಲ. - ಇತರೆ ಯಾವುದೇ
4xxಪ್ರತಿಕ್ರಿಯೆ, ಗಾತ್ರ ಮಿತಿಗಿಂತ ಹೆಚ್ಚಿನ ಪ್ರತಿಕ್ರಿಯೆ, ಅಥವಾ ಬಾಡಿಯು ಮಾನ್ಯ ಸಂರಚನೆಯಾಗಿರದ2xxಪ್ರತಿಕ್ರಿಯೆಯನ್ನು ಅಂತಿಮವೆಂದು ಪರಿಗಣಿಸಲಾಗುತ್ತದೆ ಮತ್ತು ಮರುಪ್ರಯತ್ನಿಸಲಾಗುವುದಿಲ್ಲ. - ಎರಡೂ ಪ್ರಯತ್ನಗಳು ಒಂದೇ ಬಾಡಿ, ಒಂದೇ
X-ThunderPhone-Signature, ಮತ್ತು ಒಂದೇX-ThunderPhone-Idempotency-Keyಹೆಡರ್ (telephony-incoming-<call_id>) ಕಳುಹಿಸುತ್ತವೆ, ಆದ್ದರಿಂದ ಪಾರ್ಶ್ವ ಪರಿಣಾಮಗಳನ್ನು ಹೊಂದಿರುವ ಹ್ಯಾಂಡ್ಲರ್ ಮರುಪ್ರಯತ್ನವನ್ನು ಗುರುತಿಸಬಹುದು.
ಬಳಸಬಹುದಾದ ಕಾನ್ಫಿಗರೇಶನ್ ಬರದಿದ್ದರೆ, ಕರೆಗಾರರನ್ನು ಮೌನವಾದ ಲೈನ್ನಲ್ಲಿ
ಉಳಿಸುವ ಬದಲು ಕರೆಯನ್ನು ತಕ್ಷಣವೇ ಕೊನೆಗೊಳಿಸಲಾಗುತ್ತದೆ. ಇದು ಕರೆ
ಇತಿಹಾಸದಲ್ಲಿ end_reason
inbound_config_webhook_failed ಹೊಂದಿರುವ ವಿಫಲವಾದ, ಶುಲ್ಕವಿಲ್ಲದ ಕರೆಯಾಗಿ ಕಾಣಿಸುತ್ತದೆ, ಮತ್ತು ಸಾಮಾನ್ಯ
telephony.complete ಈವೆಂಟ್ ಕಳುಹಿಸಲಾಗುತ್ತದೆ. ಡ್ಯಾಶ್ಬೋರ್ಡ್ನಲ್ಲಿನ ಕರೆಯ
ಪುಟ ಮತ್ತು
GET /v1/calls/{call_id} ನಲ್ಲಿನ config_webhook_failure ನಿಮ್ಮ ವೆಬ್ಹುಕ್
ಏನು ಮಾಡಿದೆ ಎಂಬುದನ್ನು ತಿಳಿಸುತ್ತವೆ: {kind, attempts, http_status, host, source}, ಇಲ್ಲಿ kind ಎಂದರೆ http_error,
timeout, connection, dns, tls, response_too_large,
blocked_url, other, invalid_json, non_object_json ಅಥವಾ
invalid_config; host ನಿಮ್ಮ ವೆಬ್ಹುಕ್ನ ಆತಿಥೇಯ ಹೆಸರು; ಮತ್ತು source ಎಂದರೆ
number (ಈ ವೆಬ್ಹುಕ್) ಅಥವಾ agent_setup (ಏಜೆಂಟ್ನ ಕರೆ ಹೊಂದಾಣಿಕೆ ವೆಬ್ಹುಕ್).
invalid_config ಗಾಗಿ, ಉತ್ತರವನ್ನು ಏಕೆ ಬಳಸಲಾಗಲಿಲ್ಲ ಎಂಬುದನ್ನು reason ತಿಳಿಸುತ್ತದೆ ಮತ್ತು
ಅದು ಸಂಬಂಧಿಸಿದ ಕ್ಷೇತ್ರಗಳನ್ನು fields ಹೆಸರಿಸುತ್ತದೆ: no_agent (agent_id ಅಥವಾ
prompt ಎರಡೂ ಇಲ್ಲ; ತಪ್ಪಾಗಿ ಬರೆದ agentId ನಂತಹ ನಿರ್ಲಕ್ಷಿಸಲಾದ ಕೀಲಿಗಳನ್ನು fields ಪಟ್ಟಿ ಮಾಡುತ್ತದೆ),
agent_not_found, agent_id_not_integer, unexpected_fields
(agent_id ಪಕ್ಕದಲ್ಲಿರುವ variables, context, timezone ಮತ್ತು language ಹೊರತುಪಡಿಸಿದ ಕೀಲಿಗಳು),
invalid_variables, invalid_context, invalid_language,
unsupported_language, invalid_config_fields ಅಥವಾ agent_settings_invalid.
ಇತರೆ ಸಂದರ್ಭಗಳಲ್ಲಿ reason ಎಂದರೆ null ಆಗಿರುತ್ತದೆ ಮತ್ತು fields ಖಾಲಿಯಾಗಿರುತ್ತದೆ. ಇದರ
ಒಂದೇ ವಿನಾಯಿತಿ ಎಂದರೆ ವಿನಿಮಯವೇ ವಿಫಲವಾದಾಗ ಕರೆಗಾರರು ನಿಮ್ಮ ಹೊರಹೋಗುವ ಕರೆಗಳಲ್ಲಿ ಒಂದಕ್ಕೆ ಮರಳಿ ಕರೆ ಮಾಡುವ ಸಂದರ್ಭ: ಮರಳಿ ಕರೆಗಳು ನೋಡಿ.
ವಿಜೆಟ್ ಸೆಷನ್ (web.incoming) ಗೆ ಗರಿಷ್ಠ 10 ಸೆಕೆಂಡುಗಳ ಒಂದೇ ಪ್ರಯತ್ನ ಸಿಗುತ್ತದೆ.
ಅದು ವಿಫಲವಾದರೆ, ಸೆಷನ್ ವಿನಂತಿಯು 502 ಅಥವಾ 422 ನೊಂದಿಗೆ ವಿಫಲವಾಗುತ್ತದೆ.
ವಿನಂತಿ ಪೇಲೋಡ್
ಫೋನ್ ಕರೆಗಳಿಗಾಗಿ (telephony.incoming):
{
"type": "telephony.incoming",
"data": {
"call_id": 987654321,
"from_number": "+14155550199",
"to_number": "+15551234567"
}
}| ಕ್ಷೇತ್ರ | ವಿಧ | ವಿವರಣೆ |
|---|---|---|
call_id | ಪೂರ್ಣಾಂಕ | ಕರೆ ಐಡಿ — ಈ ಕರೆಯ ಎಲ್ಲಾ ಈವೆಂಟ್ಗಳಲ್ಲಿ ಸ್ಥಿರವಾಗಿರುತ್ತದೆ |
from_number | ಸ್ಟ್ರಿಂಗ್ | E.164 ಕರೆಮಾಡುವವರ ಸಂಖ್ಯೆ |
to_number | ಸ್ಟ್ರಿಂಗ್ | E.164 ಗಮ್ಯಸ್ಥಾನ (ನಿಮ್ಮ ThunderPhone ಸಂಖ್ಯೆಗಳಲ್ಲಿ ಒಂದು) |
returning_call | ಆಬ್ಜೆಕ್ಟ್ | ಕಳೆದ 30 ದಿನಗಳಲ್ಲಿ ಈ ಸಂಖ್ಯೆಯು ಕರೆಮಾಡುವವರಿಗೆ ಕರೆ ಮಾಡಿದ್ದಾಗ ಮಾತ್ರ ಇರುತ್ತದೆ. ಮರುಕರೆಗಳು ನೋಡಿ |
sip_headers | ಆಬ್ಜೆಕ್ಟ್ | X-* ಅಥವಾ User-to-User SIP ಹೆಡರ್ಗಳೊಂದಿಗೆ ಕರೆ ಕೈಯಾರೆ SIP ಸಂಪರ್ಕದಲ್ಲಿ ಬಂದಾಗ ಮಾತ್ರ ಇರುತ್ತದೆ: ಸಣ್ಣ ಅಕ್ಷರಗಳಲ್ಲಿರುವ ಹೆಡರ್ ಹೆಸರು → ಮೌಲ್ಯ. SIP ಹೆಡರ್ಗಳು ನೋಡಿ |
ವೆಬ್ ವಿಜೆಟ್ ಸೆಷನ್ಗಳಿಗಾಗಿ (web.incoming), data ಫೋನ್ ಸಂಖ್ಯೆಗಳಿಗೆ ಬದಲಾಗಿ
ಅಳವಡಿಸಿರುವ ಪುಟವನ್ನು ಗುರುತಿಸುತ್ತದೆ:
{
"type": "web.incoming",
"data": {
"call_id": 987654322,
"origin_domain": "https://example.com",
"publishable_key_prefix": "pk_live_a1b2"
}
}| ಕ್ಷೇತ್ರ | ಪ್ರಕಾರ | ವಿವರಣೆ |
|---|---|---|
call_id | ಪೂರ್ಣಾಂಕ | ಕರೆ ಐಡಿ |
origin_domain | ಸ್ಟ್ರಿಂಗ್ | ಬ್ರೌಸರ್ ಕಳುಹಿಸಿದಂತೆ, ವಿಜೆಟ್ ಅನ್ನು ಹೋಸ್ಟ್ ಮಾಡುವ ಪುಟದ ಮೂಲ. ಬ್ರೌಸರ್-ಅಲ್ಲದ ಕ್ಲೈಂಟ್ ಯಾವುದೇ ಮೌಲ್ಯವನ್ನು ಕಳುಹಿಸಬಹುದು, ಆದ್ದರಿಂದ ಇದನ್ನು ವಿನಂತಿ ಎಲ್ಲಿಂದ ಬಂದಿದೆ ಎಂಬುದರ ಪುರಾವೆಯಾಗಿ ಪರಿಗಣಿಸಬೇಡಿ |
publishable_key_prefix | ಸ್ಟ್ರಿಂಗ್ | ಸೆಷನ್ ಅನ್ನು ತೆರೆದ ಪ್ರಕಟಿಸಬಹುದಾದ ಕೀಯ ಮೊದಲ ಅಕ್ಷರಗಳು |
language, primary_language | ಸ್ಟ್ರಿಂಗ್ | ವಿಜೆಟ್ ಸೆಷನ್ ಭಾಷಾ ಓವರ್ರೈಡ್ ಅನ್ನು ವಿನಂತಿಸಿದಾಗ ಇರುತ್ತದೆ |
voice | ಸ್ಟ್ರಿಂಗ್ | ವಿಜೆಟ್ ಸೆಷನ್ ಧ್ವನಿ ಓವರ್ರೈಡ್ ಅನ್ನು ವಿನಂತಿಸಿದಾಗ ಇರುತ್ತದೆ |
website_context | ಸ್ಟ್ರಿಂಗ್ | ವಿಜೆಟ್ ಪ್ರತಿ-ಸೆಷನ್ ಪುಟದ ಸಂದರ್ಭವನ್ನು ರವಾನಿಸಿದಾಗ ಇರುತ್ತದೆ |
ಓವರ್ರೈಡ್ ಕ್ಷೇತ್ರಗಳು (language, voice, website_context, ಮತ್ತು ಯಾವುದೇ
ಬ್ರೌಸರ್ variables) ಪ್ರಕಟಿಸಬಹುದಾದ ಕೀ ತನ್ನ
ಬ್ರೌಸರ್ ಓವರ್ರೈಡ್ಗಳಲ್ಲಿ ಅವುಗಳನ್ನು ಅನುಮತಿಸಿದಾಗ ಮಾತ್ರ ಬರುತ್ತವೆ. ಕೀ ಅನುಮತಿಸದ ಒಂದನ್ನು ಹೊಂದಿರುವ ಸೆಷನ್ ವಿನಂತಿಯನ್ನು
ಈ ವೆಬ್ಹುಕ್ ಕರೆಯುವ ಮೊದಲು ತಿರಸ್ಕರಿಸಲಾಗುತ್ತದೆ.
ಪ್ರತಿಕ್ರಿಯೆ ಸ್ಕೀಮಾ
ಈ ಕರೆಯ ಏಜೆಂಟ್ ಕಾನ್ಫಿಗರೇಶನ್ ಅನ್ನು ವಿವರಿಸುವ JSON ಆಬ್ಜೆಕ್ಟ್ ಅನ್ನು ಹಿಂತಿರುಗಿಸಿ.
prompt ಮತ್ತು voice ಅಗತ್ಯವಿದೆ; ಉಳಿದ ಎಲ್ಲವೂ ಐಚ್ಛಿಕ.
{
"prompt": "You are a helpful booking assistant for Acme Restaurant.",
"voice": "john",
"product": "spark",
"background_track": null,
"tools": []
}| ಕ್ಷೇತ್ರ | ಪ್ರಕಾರ | ಅಗತ್ಯವಿದೆ | ವಿವರಣೆ |
|---|---|---|---|
prompt | ಸ್ಟ್ರಿಂಗ್ | ಹೌದು | ಏಜೆಂಟ್ ಅನ್ನು ಚಾಲನೆ ಮಾಡುವ ಸಿಸ್ಟಮ್ prompt |
voice | ಸ್ಟ್ರಿಂಗ್ | ಹೌದು | GET /v1/voices ನಿಂದ ಧ್ವನಿ ಐಡಿ, ಉದಾ. john. voice_name ಅನ್ನು ಪರ್ಯಾಯ ಹೆಸರಾಗಿ ಸ್ವೀಕರಿಸಲಾಗುತ್ತದೆ. ಅಪರಿಚಿತ ಧ್ವನಿಗಳು ಮೌಲ್ಯೀಕರಣದಲ್ಲಿ ವಿಫಲವಾಗಿ ಕರೆಯನ್ನು ನಿರಾಕರಿಸುತ್ತವೆ |
product | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | bolt ಕಳುಹಿಸಿ. ಪೂರ್ವನಿಯೋಜಿತವು spark; ಇದು ಹಳೆಯ ಮೌಲ್ಯವಾಗಿದ್ದು storm-base, storm-base-with-ack, storm-extra ಮತ್ತು storm-extra-with-ack ಜೊತೆಗೆ ಇನ್ನೂ ಸ್ವೀಕರಿಸಲಾಗುತ್ತದೆ |
thinking_level | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | minimal, base (ಪೂರ್ವನಿಯೋಜಿತ), ಅಥವಾ extra. ಹಳೆಯ storm-* ಉತ್ಪನ್ನ ಮೌಲ್ಯಗಳಲ್ಲಿ, storm-extra* extra ಅನ್ನು ಬಲವಂತಗೊಳಿಸುತ್ತದೆ ಮತ್ತು ಇತರ storm-* ಗಳು base ಅನ್ನು ಬಲವಂತಗೊಳಿಸುತ್ತವೆ |
audio_context_mode | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | full (ಪೂರ್ವನಿಯೋಜಿತ) ಅಥವಾ reduced |
watchdog_enabled | ಬೂಲಿಯನ್ | ಇಲ್ಲ | ಈ ಕರೆಗೆ ಮೇಲ್ವಿಚಾರಣೆಯನ್ನು ಸಕ್ರಿಯಗೊಳಿಸಿ. ಪೂರ್ವನಿಯೋಜಿತ false |
additional_audio_context | ಬೂಲಿಯನ್ | ನಲ್ | ಇಲ್ಲ | ಇತ್ತೀಚಿನ ಸರದಿಯನ್ನು ಮಾತ್ರ ಸೇರಿಸುವ ಬದಲು ಕರೆಮಾಡುವವರ ಆಡಿಯೊದ ಕೊನೆಯ ಕೆಲವು ಸರದಿಗಳನ್ನು ಸೇರಿಸಿ; ಇದು ಸ್ವಲ್ಪ ವಿಳಂಬ/ವೆಚ್ಚದ ಹೆಚ್ಚುವರಿಯೊಂದಿಗೆ ತಿದ್ದುಪಡಿಗಳು ಮತ್ತು ಕಾಗುಣಿತ/ಸಂಖ್ಯೆ-ಹೆಚ್ಚಿರುವ ದತ್ತಾಂಶ ಸಂಗ್ರಹಣೆಯನ್ನು ಸುಧಾರಿಸುತ್ತದೆ. ಒಳಬರುವ ಸೆಷನ್ಗಳಿಗೆ ಪೂರ್ವನಿಯೋಜಿತವಾಗಿ ಆನ್ ಆಗಿರುತ್ತದೆ ಮತ್ತು ಹೊರಹೋಗುವ ಫೋನ್ ಕರೆಗಳಿಗೆ ಆಫ್ ಆಗಿರುತ್ತದೆ; null ಪೂರ್ವನಿಯೋಜಿತವನ್ನು ಉಳಿಸಿಕೊಳ್ಳುತ್ತದೆ |
storm_feedback_mode | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | none, acknowledgement (ಪೂರ್ವನಿಯೋಜಿತ), ಅಥವಾ tick: audio_tier plus ಅಥವಾ max ಆಗಿರುವಾಗ ನಿಧಾನವಾದ ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು ಸಿದ್ಧಪಡಿಸುತ್ತಿರುವ ವೇಳೆ ಕರೆಮಾಡುವವರು ಏನು ಕೇಳುತ್ತಾರೆ |
language | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | primary_language ಗಾಗಿ ಸಂಕ್ಷಿಪ್ತ ರೂಪ. agent_id ಜೊತೆಯಲ್ಲಿಯೂ ಅನುಮತಿಸಲಾಗಿದೆ; ಅಲ್ಲಿ ಇದು ಈ ಕರೆ ಆರಂಭವಾಗುವ ಭಾಷೆಯಾಗಿದ್ದು, ಅದಕ್ಕಾಗಿರುವ ಏಜೆಂಟ್ನ ಧ್ವನಿಯಲ್ಲಿ ಮಾತನಾಡಲಾಗುತ್ತದೆ; ಪ್ರತಿ ಕರೆಗೆ ಭಾಷೆಯನ್ನು ಹೊಂದಿಸಿ ನೋಡಿ |
primary_language | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | ಸಾಮಾನ್ಯೀಕರಿಸಿದ ಭಾಷಾ ಸಂಕೇತ (ಪೂರ್ವನಿಯೋಜಿತ en). ಪರಿಹರಿಸಲಾಗದ ಸಂಕೇತಗಳು ಕರೆಯನ್ನು ನಿರಾಕರಿಸುತ್ತವೆ |
has_additional_languages | ಬೂಲಿಯನ್ | ಇಲ್ಲ | ಪೂರ್ವನಿಯೋಜಿತ false |
additional_languages | ಸ್ಟ್ರಿಂಗ್ನ ಅರೆ | ಇಲ್ಲ | ಏಜೆಂಟ್ ಬದಲಾಯಿಸಬಹುದಾದ ಹೆಚ್ಚುವರಿ ಭಾಷೆಗಳು |
native_voice_switching | ಬೂಲಿಯನ್ | ಇಲ್ಲ | ಪೂರ್ವನಿಯೋಜಿತ false. ಕರೆ ಮತ್ತೊಂದು ಭಾಷೆಗೆ ಬದಲಾದಾಗ, ಕಾನ್ಫಿಗರ್ ಮಾಡಿದ ಧ್ವನಿಯನ್ನು ಉಳಿಸಿಕೊಳ್ಳುವ ಬದಲು ಆ ಭಾಷೆಗೆ ಸ್ಥಳೀಯವಾದ ಧ್ವನಿಗೆ ಬದಲಾಯಿಸಿ (ಲಿಂಗಕ್ಕೆ ಹೊಂದಿಕೆಯಾಗುವಂತೆ) |
language_switching | ಸ್ಟ್ರಿಂಗ್ | ನಲ್ | ಇಲ್ಲ | ask_first (ಪೂರ್ವನಿಯೋಜಿತ) ಅಥವಾ follow_caller; null ಎಂಬುದು ask_first ನಂತೆಯೇ. ಬಹುಭಾಷಾ ಏಜೆಂಟ್ ತನ್ನ ಇತರ ಭಾಷೆಗಳಲ್ಲಿ ಒಂದನ್ನು ಎದುರಿನ ವ್ಯಕ್ತಿ ಮಾತನಾಡಿದಾಗ ಅದನ್ನು ಹೇಗೆ ನಿರ್ವಹಿಸುತ್ತದೆ. ಅವರು ಭಾಷೆಯನ್ನು ಕೇಳಿದಾಗ ಅಥವಾ ಅದರಲ್ಲಿ ಪೂರ್ಣ ವಾಕ್ಯ ಹೇಳಿದಾಗ ask_first ತಕ್ಷಣ ಬದಲಾಯಿಸುತ್ತದೆ ಮತ್ತು "sí" ಯಂತಹ ಚಿಕ್ಕದಾದುದರ ನಂತರ ಅದನ್ನು ಮುಂದುವರಿಸಬೇಕೇ ಎಂದು ಕೇಳುತ್ತದೆ. follow_caller ಅವರು ಮಾತನಾಡುವ ಯಾವುದೇ ಕಾನ್ಫಿಗರ್ ಮಾಡಿದ ಭಾಷೆಗೆ, ಒಂದೇ ಪದವಾಗಿದ್ದರೂ, ಬದಲಾಗುತ್ತದೆ. additional_languages ಹೊಂದಿಸಿದಾಗ ಮಾತ್ರ ಅನ್ವಯಿಸುತ್ತದೆ |
audio_tier | ಸ್ಟ್ರಿಂಗ್ | ನಲ್ | ಇಲ್ಲ | product: "bolt" ಗೆ ಮಾತ್ರ. ಆಲಿಕೆ: ಏಜೆಂಟ್ ಕರೆಮಾಡುವವರನ್ನು ಎಷ್ಟು ಎಚ್ಚರಿಕೆಯಿಂದ ಆಲಿಸುತ್ತದೆ. standard (ಪೂರ್ವನಿಯೋಜಿತ; "" ಮತ್ತು null ಒಂದೇ ಅರ್ಥ) ಬಹುತೇಕ ಕರೆಗಳಿಗೆ ಸೂಕ್ತವಾಗಿದೆ (PHI ಅನ್ನು ಪ್ರಕ್ರಿಯೆಗೊಳಿಸುವ ಕರೆಗಳು BAA-ಒಳಗೊಂಡ ಪೂರೈಕೆದಾರರನ್ನು ಮಾತ್ರ ಬಳಸುತ್ತವೆ). lite ಅಗ್ಗವಾಗಿದೆ ಮತ್ತು ಹೆಚ್ಚು ಬಾರಿ ತಪ್ಪಾಗಿ ಕೇಳುತ್ತದೆ. plus ಕಷ್ಟಕರ ಸರದಿಗಳಲ್ಲಿ ಹೆಚ್ಚು ಗಮನದಿಂದ ಆಲಿಸುತ್ತದೆ; ಇವು ಸುಮಾರು 1–2 ಸೆಕೆಂಡು ಹೆಚ್ಚು ಸಮಯ ತೆಗೆದುಕೊಳ್ಳುತ್ತವೆ. max ಅತ್ಯಂತ ಕಷ್ಟಕರ ಆಡಿಯೊ ಮತ್ತು ಅಪರೂಪದ ಭಾಷೆಗಳಿಗಾಗಿ; ಪ್ರತಿಯೊಂದು ಪ್ರತಿಕ್ರಿಯೆ 3–4 ಸೆಕೆಂಡು ತೆಗೆದುಕೊಳ್ಳುತ್ತದೆ ಮತ್ತು ಕರೆ pro ಬುದ್ಧಿಮತ್ತೆಯನ್ನು ಚಲಾಯಿಸುತ್ತದೆ (intelligence ನಿರ್ಲಕ್ಷಿಸಲಾಗುತ್ತದೆ). max ಸಾಮಾನ್ಯವಾಗಿ ಲಭ್ಯವಿಲ್ಲ: ಸಂಸ್ಥೆಗೆ ಇದನ್ನು ಸಕ್ರಿಯಗೊಳಿಸದಿದ್ದರೆ, ಕರೆ plus ಮತ್ತು ನೀವು ಹೆಸರಿಸುವ intelligence ನೊಂದಿಗೆ ಚಲಿಸುತ್ತದೆ (ಇದನ್ನು ಹೊಂದಿರುವ ಹೊರಹೋಗುವ ಕರೆ ವಿನಂತಿಯನ್ನು 400 ನೊಂದಿಗೆ ನಿರಾಕರಿಸಲಾಗುತ್ತದೆ). ಹಳೆಯ lean (ಲೈಟ್), hearing (ಪ್ಲಸ್) ಮತ್ತು deep_hearing (ಮ್ಯಾಕ್ಸ್) ಮೌಲ್ಯಗಳನ್ನೂ ಇನ್ನೂ ಸ್ವೀಕರಿಸಲಾಗುತ್ತದೆ. ಇತರ ಉತ್ಪನ್ನಗಳು ಇದನ್ನು ನಿರ್ಲಕ್ಷಿಸುತ್ತವೆ |
endpointing | ಸ್ಟ್ರಿಂಗ್ | ನಲ್ | ಇಲ್ಲ | faster (200 ಮಿ.ಸೆ.), fast (300 ಮಿ.ಸೆ.), normal (500 ಮಿ.ಸೆ., ಪೂರ್ವನಿಯೋಜಿತ) ಅಥವಾ patient (800 ಮಿ.ಸೆ.); null ಎಂಬುದು normal ನಂತೆಯೇ. ಕರೆಮಾಡುವವರು ನಿಲ್ಲಿಸಿದ ನಂತರ ಪ್ರತಿಕ್ರಿಯೆಗಾಗಿ ಮಾಡೆಲ್ ಅನ್ನು ಕೇಳುವ ಮುನ್ನ Bolt v2 ಏಜೆಂಟ್ ಎಷ್ಟು ಸಮಯ ಕಾಯುತ್ತದೆ. ಕಡಿಮೆ ಕಾಯುವಿಕೆಗಳು ಬೇಗ ಉತ್ತರಿಸಬಹುದು, ಆದರೆ ಕರೆಮಾಡುವವರ ಮುಂದಿನ ಪದಗಳಿಂದ ಹಳೆಯದಾಗುವ ಹೆಚ್ಚಿನ ವಿನಂತಿಗಳನ್ನು ಕಳುಹಿಸುತ್ತವೆ; ಇದರಿಂದ ಮಾಡೆಲ್ ವೆಚ್ಚ ಹೆಚ್ಚುತ್ತದೆ. ಇತರ ಉತ್ಪನ್ನಗಳು ಇದನ್ನು ನಿರ್ಲಕ್ಷಿಸುತ್ತವೆ |
eagerness | ಸ್ಟ್ರಿಂಗ್ | ನಲ್ | ಇಲ್ಲ | ಅಸಮ್ಮತಿಸಲಾಗಿದೆ: ಅಕ್ಟೋಬರ್ 19, 2026 ರವರೆಗೆ endpointing ನ ಹೆಸರು; ಇನ್ನೂ ಓದಲಾಗುತ್ತದೆ. endpointing ಹೊಂದಿಸಿದಾಗ ನಿರ್ಲಕ್ಷಿಸಲಾಗುತ್ತದೆ |
intelligence | ಸ್ಟ್ರಿಂಗ್ | ನಲ್ | ಇಲ್ಲ | core ಅಥವಾ pro (ಪೂರ್ವನಿಯೋಜಿತ); null ಎಂಬುದು pro ನಂತೆಯೇ. Bolt v2 ಪೈಪ್ಲೈನ್ನಲ್ಲಿನ bolt ಏಜೆಂಟ್ ತನ್ನ ಸೂಚನೆಗಳನ್ನು ಎಷ್ಟು ವಿಶ್ವಾಸಾರ್ಹವಾಗಿ ಅನುಸರಿಸುತ್ತದೆ. core ಮೊದಲ ಪದಕ್ಕೆ ~700 ಮಿ.ಸೆ. ತೆಗೆದುಕೊಳ್ಳುತ್ತದೆ, ಅಗ್ಗವಾಗಿದೆ ಮತ್ತು ಸ್ವಲ್ಪ ಕಡಿಮೆ ವಿಶ್ವಾಸಾರ್ಹವಾಗಿದೆ (PHI ಎಂದು ಪರಿಗಣಿಸಲಾದ ಕರೆಗಳಲ್ಲಿ ~900 ಮಿ.ಸೆ. ಮತ್ತು ಕಡಿಮೆ ವಿಶ್ವಾಸಾರ್ಹ); pro ~900 ಮಿ.ಸೆ.; ಕೇವಲ ಉಪಕರಣವನ್ನು ಕರೆಯುವ ಕೋರ್ ಪ್ರತಿಕ್ರಿಯೆಗಳನ್ನು ಪ್ರೊಗೆ ಹಸ್ತಾಂತರಿಸಲಾಗುತ್ತದೆ. ಹಳೆಯ lite (ಕೋರ್) ಮತ್ತು standard (ಪ್ರೊ) ಮೌಲ್ಯಗಳನ್ನೂ ಇನ್ನೂ ಸ್ವೀಕರಿಸಲಾಗುತ್ತದೆ ಮತ್ತು ಸ್ಥಗಿತಗೊಂಡ plus ಹಾಗೂ max pro ನಲ್ಲಿ ಚಲಿಸುತ್ತವೆ. audio_tier max ಆಗಿರುವಾಗ ನಿರ್ಲಕ್ಷಿಸಲಾಗುತ್ತದೆ. ಇತರ ಉತ್ಪನ್ನಗಳು ಇದನ್ನು ನಿರ್ಲಕ್ಷಿಸುತ್ತವೆ |
faster_replies | ಬೂಲಿಯನ್ | ನಲ್ | ಇಲ್ಲ | ವೇಗ ವರ್ಧನೆ. ಪೂರ್ವನಿಯೋಜಿತ true. Bolt v2 ಪೈಪ್ಲೈನ್ನ bolt ಏಜೆಂಟ್ನಲ್ಲಿ, ಪ್ರತಿಕ್ರಿಯೆಗಳು ಸ್ವಲ್ಪ ಹೆಚ್ಚಿನ ವೆಚ್ಚಕ್ಕೆ ಸ್ವಲ್ಪ ಬೇಗ ಆರಂಭವಾಗುತ್ತವೆ. false ಅದನ್ನು ಆಫ್ ಮಾಡುತ್ತದೆ. ಇತರ ಉತ್ಪನ್ನಗಳು ಇದನ್ನು ನಿರ್ಲಕ್ಷಿಸುತ್ತವೆ |
background_track | ಸ್ಟ್ರಿಂಗ್ | ನಲ್ | ಇಲ್ಲ | ಸುತ್ತುವರಿದ ಆಡಿಯೊ ಐಡಿ ಅಥವಾ null |
acknowledgement_prompt_mode | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | auto (ಪೂರ್ವನಿಯೋಜಿತ) ಅಥವಾ manual (ಹಳೆಯ -with-ack ಉತ್ಪನ್ನ ಮೌಲ್ಯಗಳು) |
acknowledgement_prompt | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | acknowledgement_prompt_mode="manual" ಆಗಿರುವಾಗ ಬಳಸಲಾಗುತ್ತದೆ |
silence_interval_seconds | ಪೂರ್ಣಾಂಕ | ನಲ್ | ಇಲ್ಲ | 5–120. ಪರಿಶೀಲನೆಗೂ ಮುನ್ನದ ಕರೆಮಾಡುವವರ ಮೌನದ ಸೆಕೆಂಡುಗಳು |
silence_max_checkins | ಪೂರ್ಣಾಂಕ | ನಲ್ | ಇಲ್ಲ | 1–10 |
silence_checkins_enabled | ಬೂಲಿಯನ್ | ಇಲ್ಲ | ಪೂರ್ವನಿಯೋಜಿತ true |
silence_final_action | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | ಕೊನೆಯ ಪರಿಶೀಲನೆಯ ನಂತರ: hang_up (ಪೂರ್ವನಿಯೋಜಿತ) ಅಥವಾ silence_transfer_destination ಗೆ transfer |
silence_transfer_destination | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | ಈ ಕಾನ್ಫಿಗ್ನ transfer_destinations ನಲ್ಲಿನ ನಮೂದಿನ ಹೆಸರು; transfer ಜೊತೆಗೆ ಅಗತ್ಯವಿದೆ. transfer_destinations ಇಲ್ಲದೆ ವರ್ಗಾವಣೆಯನ್ನು ಮಾಡಲಾಗುವುದಿಲ್ಲ ಮತ್ತು ಏಜೆಂಟ್ ಕರೆ ಸ್ಥಗಿತಗೊಳಿಸುತ್ತದೆ |
silence_final_message | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | ≤ 300 ಅಕ್ಷರಗಳು, ಬರೆದಂತೆಯೇ ಓದಲಾಗುತ್ತದೆ; "" (ಪೂರ್ವನಿಯೋಜಿತ) ಪೂರ್ವನಿಯೋಜಿತ ಸಾಲನ್ನು ಬಳಸುತ್ತದೆ |
connect_tone_enabled | ಬೂಲಿಯನ್ | ಇಲ್ಲ | ಪೂರ್ವನಿಯೋಜಿತ false |
pronunciation_dicts | ಬೂಲಿಯನ್ | ನಲ್ | ಇಲ್ಲ | ಪೂರ್ವನಿಯೋಜಿತ false; null ಎಂಬುದು false ನಂತೆಯೇ. true ಆಗಿದ್ದಾಗ, ಕರೆಯ ಭಾಷೆಗೆ ಇರುವಲ್ಲಿ ಆ ಕರೆಯ Cartesia ಮಾತು ThunderPhone ನ ಉಚ್ಚಾರಣಾ ನಿಘಂಟನ್ನು ಬಳಸುತ್ತದೆ. ಫೋನ್ ಮತ್ತು ವಿಜೆಟ್ ಕರೆಗಳಿಗೆ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತದೆ. ನಿಮ್ಮ ಸ್ವಂತ Cartesia API ಕೀಯಲ್ಲಿರುವ ಧ್ವನಿಗಳಿಗೆ ಅಲ್ಲ, ThunderPhone ನ ಸ್ವಂತ Cartesia ಧ್ವನಿಗಳಿಗೆ ಮಾತ್ರ ಅನ್ವಯಿಸುತ್ತದೆ. ಉಳಿಸಿದ ಏಜೆಂಟ್ನ ಸೆಟ್ಟಿಂಗ್ಗಳು ಅನ್ವಯವಾಗುವ agent_id ಜೊತೆಗೆ ಬಳಸಲಾಗುವುದಿಲ್ಲ |
words | ಅರೆ | ನಲ್ | ಇಲ್ಲ | ಏಜೆಂಟ್ ನಿರ್ದಿಷ್ಟ ಪದಗಳನ್ನು ಹೇಗೆ ಉಚ್ಚರಿಸುತ್ತದೆ; support ಇಲ್ಲದ ಏಜೆಂಟ್ನ words ನಂತೆಯೇ ನಮೂದುಗಳು. language ಇಲ್ಲದ ನಮೂದು ಈ ಕಾನ್ಫಿಗ್ನ ಭಾಷೆಯನ್ನು ತೆಗೆದುಕೊಳ್ಳುತ್ತದೆ. null ಮತ್ತು [] ಎಂದರೆ ಯಾವುದೂ ಇಲ್ಲ. ಉಳಿಸಿದ ಏಜೆಂಟ್ನ ಪದಗಳು ಅನ್ವಯವಾಗುವ agent_id ಜೊತೆಗೆ ಬಳಸಲಾಗುವುದಿಲ್ಲ |
voicemail_action | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | prompt (ಪೂರ್ವನಿಯೋಜಿತ), hangup, ಅಥವಾ message |
voicemail_message | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | voicemail_action="message" ಆಗಿರುವಾಗ ಬಳಸಲಾಗುತ್ತದೆ |
agent_name | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | ಡ್ಯಾಶ್ಬೋರ್ಡ್ಗಳು ಮತ್ತು ವಿಜೆಟ್ಗೆ ವರದಿ ಮಾಡಲಾದ ಪ್ರದರ್ಶನ ಹೆಸರು |
org_name | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | ಏಜೆಂಟ್ನ ವ್ಯಕ್ತಿತ್ವಕ್ಕಾಗಿ ಸಂಸ್ಥೆಯ ಪ್ರದರ್ಶನ ಹೆಸರು |
tools | ಅರೆ | ಇಲ್ಲ | ಇನ್ಲೈನ್ ಕಾರ್ಯ-ಉಪಕರಣ ಸ್ಕೀಮಾಗಳು (ಕಾರ್ಯ ಉಪಕರಣಗಳು ನೋಡಿ) |
transfer_destinations | ಆಬ್ಜೆಕ್ಟ್ನ ಅರೆ | ನಲ್ | ಇಲ್ಲ | ಈ ಕರೆ ವರ್ಗಾಯಿಸಬಹುದಾದ ಗರಿಷ್ಠ 50 {name, number} ನಮೂದುಗಳು; ಏಜೆಂಟ್ನ ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆಗಳು ರೀತಿಯಲ್ಲೇ ಮೌಲ್ಯೀಕರಿಸಲಾಗುತ್ತದೆ. ಏಜೆಂಟ್ ಹೆಸರಿನ ಮೂಲಕ ಮತ್ತು ಇವಕ್ಕೆ ಮಾತ್ರ ವರ್ಗಾಯಿಸುತ್ತದೆ; [] ಎಂದರೆ ವರ್ಗಾವಣೆಗಳಿಲ್ಲ. ಏಜೆಂಟ್ ಆಯ್ಕೆಮಾಡುವ ಸಂಖ್ಯೆಗೆ ವರ್ಗಾಯಿಸಲು ಇದನ್ನು ಬಿಟ್ಟುಬಿಡಿ ಅಥವಾ null ಕಳುಹಿಸಿ |
timezone | ಸ್ಟ್ರಿಂಗ್ | ಇಲ್ಲ | America/Chicago ನಂತಹ ಈ ಕರೆಗಾಗಿ IANA ಸಮಯ ವಲಯ. ಏಜೆಂಟ್ ತನ್ನ ಸ್ವಂತ ಸಮಯ ವಲಯಕ್ಕಿಂತ ಮೊದಲು ಇದರಲ್ಲಿನ ದಿನಾಂಕ ಮತ್ತು ಸಮಯವನ್ನು ಹೇಳುತ್ತದೆ. agent_id ಜೊತೆಯಲ್ಲಿಯೂ ಅನುಮತಿಸಲಾಗಿದೆ. IANA ವಲಯಗಳಲ್ಲದ ಮೌಲ್ಯಗಳನ್ನು ನಿರ್ಲಕ್ಷಿಸಲಾಗುತ್ತದೆ. ಪ್ರತಿ ಕರೆಗೆ ಸಮಯ ವಲಯವನ್ನು ಹೊಂದಿಸಿ ನೋಡಿ |
context | ಸ್ಟ್ರಿಂಗ್ | ನಲ್ | ಇಲ್ಲ | ನಿಮ್ಮ ಸಿಸ್ಟಮ್ ಸಂಗ್ರಹಿಸಿದ ಟಿಪ್ಪಣಿಗಳಂತಹ ಈ ಕರೆಗಾಗಿನ ಮುಕ್ತ-ರೂಪದ ಪಠ್ಯ, ಗರಿಷ್ಠ 20,000 ಅಕ್ಷರಗಳು. prompt ನಂತರ ಗಡಿನಿರ್ಧರಿತ ಬ್ಲಾಕ್ನಲ್ಲಿ ಸೇರಿಸಲಾಗುತ್ತದೆ ಮತ್ತು ಟೆಂಪ್ಲೇಟ್ ಆಗಿ ರೆಂಡರ್ ಆಗುವುದಿಲ್ಲ. agent_id ಜೊತೆಯಲ್ಲಿಯೂ ಅನುಮತಿಸಲಾಗಿದೆ. ಸ್ಟ್ರಿಂಗ್ ಅಲ್ಲದ ಅಥವಾ ಹೆಚ್ಚು ಉದ್ದದ ಮೌಲ್ಯವು ಕರೆಯನ್ನು ನಿರಾಕರಿಸುತ್ತದೆ. ಕರೆ ವೇರಿಯಬಲ್ಗಳು ಮತ್ತು ಸಂದರ್ಭ ನೋಡಿ |
call_id | ಪೂರ್ಣಾಂಕ | ಇಲ್ಲ | ವಿನಂತಿಯ ಕರೆ ಐಡಿಯ ಐಚ್ಛಿಕ ಪ್ರತಿಧ್ವನಿ; ನಿರ್ಲಕ್ಷಿಸಲಾಗುತ್ತದೆ |
prompt ಮತ್ತು voice ಅಗತ್ಯವಾಗಿರುವುದರಿಂದ, {} ಅಥವಾ ಪರಿಶೀಲನೆಯಲ್ಲಿ ವಿಫಲವಾಗುವ ಯಾವುದೇ ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು ಹಿಂತಿರುಗಿಸಿದರೆ ಕರೆ ನಿರಾಕರಿಸಲಾಗುತ್ತದೆ: ಕಾಲಾವಧಿ ಮಿತಿಗಳು ಮತ್ತು ಮರುಪ್ರಯತ್ನಗಳು ನಲ್ಲಿ ವಿವರಿಸಿದಂತೆ ಫೋನ್ ಕರೆ ಕೊನೆಗೊಳ್ಳುತ್ತದೆ ಮತ್ತು ವಿಜೆಟ್ ಸೆಷನ್ ವಿನಂತಿಯು 422 ನೊಂದಿಗೆ ವಿಫಲಗೊಳ್ಳುತ್ತದೆ. ಇದು ಮರುಕರೆ ಮಾಡುವವರಿಗೂ ಅನ್ವಯಿಸುತ್ತದೆ: ನಿಮ್ಮ ವೆಬ್ಹುಕ್ ಹಿಂತಿರುಗಿಸುವ ಯಾವುದೇ JSON ಆಬ್ಜೆಕ್ಟ್ ಅದರ ಉತ್ತರವಾಗಿರುತ್ತದೆ ಮತ್ತು {} ಎಂಬುದು ಕರೆಯನ್ನು ನಿರಾಕರಿಸುವ ವಿಧಾನವಾಗಿದೆ.
ಏಜೆಂಟ್ ಕರೆ ಹೊಂದಿಕೆ ವೆಬ್ಹುಕ್
ಏಜೆಂಟ್ ತನ್ನದೇ ಆದ ಕರೆ ಹೊಂದಿಕೆ ವೆಬ್ಹುಕ್ ಹೊಂದಿರಬಹುದು: ಅದರ ಸೆಟ್ಟಿಂಗ್ಗಳಲ್ಲಿನ ಕರೆ ಹೊಂದಿಕೆ ವೆಬ್ಹುಕ್
ಕ್ಷೇತ್ರ, ಅಥವಾ API ಯಲ್ಲಿನ call_setup_webhook_url.
ಏಜೆಂಟ್ ಅನ್ನು ಒಂದು ಸಂಖ್ಯೆಗೆ ನಿಯೋಜಿಸಿ; ಆ ಸಂಖ್ಯೆಗೆ ಬರುವ ಪ್ರತಿ ಒಳಬರುವ ಕರೆಗೆ
ಏಜೆಂಟ್ ಉತ್ತರಿಸುವ ಮೊದಲು, ThunderPhone ಆ ಕರೆಯ ವೇರಿಯಬಲ್ಗಳು ಮತ್ತು ಸಂದರ್ಭಕ್ಕಾಗಿ
ವೆಬ್ಹುಕ್ ಅನ್ನು ಕೇಳುತ್ತದೆ. ಸಂಖ್ಯೆಯು ತನ್ನ ಏಜೆಂಟ್ ಅನ್ನು ಉಳಿಸಿಕೊಳ್ಳುತ್ತದೆ, ಆದ್ದರಿಂದ ಫೋನ್
ಸಂಖ್ಯೆಗಳ ಪುಟ ಮತ್ತು ಏಜೆಂಟ್ ಪುಟವು ಅದಕ್ಕೆ ಯಾವ ಏಜೆಂಟ್ ಉತ್ತರಿಸುತ್ತದೆ ಎಂಬುದನ್ನು ತೋರಿಸುತ್ತವೆ.
ಇದು ಏಜೆಂಟ್ನ ಇತರ ಸೆಟ್ಟಿಂಗ್ಗಳಂತೆಯೇ ಇರುವ ಸೆಟ್ಟಿಂಗ್ ಆಗಿದೆ: ಕರಡಾಗಿ ಹಂತಗೊಳಿಸಲಾಗುತ್ತದೆ,
ನಿಯೋಜನೆಯ ಸಮಯದಲ್ಲಿ ಪ್ರಕಟಿಸಲಾಗುತ್ತದೆ ಮತ್ತು ಆವೃತ್ತಿ ಇತಿಹಾಸದಲ್ಲಿ ಉಳಿಸಲಾಗುತ್ತದೆ. ಒಂದು ಸಂಖ್ಯೆ
ಹಿಂದಿನ ಆವೃತ್ತಿಗೆ ಪಿನ್ ಮಾಡಿದ್ದರೆ,
ಆ ಆವೃತ್ತಿಯ URL ಅನ್ನು ಕೇಳುತ್ತದೆ. ವಿನಂತಿಗಳಿಗೆ ಏಜೆಂಟ್ನ ಸ್ವಂತ
call_setup_webhook_signing_secret ಮೂಲಕ ಸಹಿ ಮಾಡಲಾಗುತ್ತದೆ (ಸಂಸ್ಥೆಯ ವೆಬ್ಹುಕ್
ರಹಸ್ಯವಲ್ಲ); ಮೇಲಿನ ಅದೇ X-ThunderPhone-Signature ಹೆಡರ್,
ಕಾಲಮಿತಿಗಳು, ಮರುಪ್ರಯತ್ನ ಮತ್ತು ಐಡೆಂಪೋಟೆನ್ಸಿ ಕೀಯೊಂದಿಗೆ. ಈ ರಹಸ್ಯವು ಬರೆಯಲು ಮಾತ್ರ
ಲಭ್ಯವಿದೆ: ನಿಮ್ಮ ಎಂಡ್ಪಾಯಿಂಟ್ ಪರಿಶೀಲಿಸುವ ಒಂದನ್ನು ಹೊಂದಿಸಿ (ಏಜೆಂಟ್ನ ಸೆಟ್ಟಿಂಗ್ಗಳಲ್ಲಿ, ಅಥವಾ
PATCH /v1/agents/{id} ಮೂಲಕ); ಯಾವುದೇ ಓದುವಿಕೆ ಇದನ್ನು ಹಿಂತಿರುಗಿಸುವುದಿಲ್ಲ, ಮತ್ತು
call_setup_webhook_signing_secret_set ಒಂದು ಹೊಂದಿಸಲಾಗಿದೆಯೇ ಎಂಬುದನ್ನು ತಿಳಿಸುತ್ತದೆ.
ವಿನಂತಿಯು ಮೇಲಿನ telephony.incoming ಪೇಲೋಡ್ ಜೊತೆಗೆ ಮೌಲ್ಯಗಳನ್ನು ತುಂಬಲಾಗುತ್ತಿರುವ
ಏಜೆಂಟ್ ಅನ್ನೂ ಒಳಗೊಂಡಿರುತ್ತದೆ:
{
"type": "telephony.incoming",
"data": {
"call_id": 987654321,
"from_number": "+14155550199",
"to_number": "+15551234567",
"variables": null,
"agent": {
"id": 12,
"name": "Front desk",
"version": 7,
"version_pinned": false
}
}
}| ಕ್ಷೇತ್ರ | ಪ್ರಕಾರ | ವಿವರಣೆ |
|---|---|---|
agent.id | ಪೂರ್ಣಾಂಕ | ಸಂಖ್ಯೆಗೆ ನಿಯೋಜಿಸಲಾದ ಏಜೆಂಟ್ |
agent.name | ಸ್ಟ್ರಿಂಗ್ | ಅದರ ಹೆಸರು |
agent.version | ಪೂರ್ಣಾಂಕ | null | ಉತ್ತರಿಸುವ ಆವೃತ್ತಿಯ ಸಂಖ್ಯೆ: ಸಂಖ್ಯೆಯ ಪಿನ್ ಮಾಡಲಾದ ಆವೃತ್ತಿ, ಇಲ್ಲದಿದ್ದರೆ ಏಜೆಂಟ್ನ ಇತ್ತೀಚಿನ ಪ್ರಕಟಿತ ಆವೃತ್ತಿ (ಯಾವುದೂ ಇಲ್ಲದಿದ್ದರೆ null) |
agent.version_pinned | ಬೂಲಿಯನ್ | ಸಂಖ್ಯೆಯು ಆ ಆವೃತ್ತಿಗೆ ಪಿನ್ ಮಾಡಲಾಗಿದೆಯೇ ಎಂಬುದು |
ಕರೆಗೆ ಬೇಕಾದುದರೊಂದಿಗೆ ಪ್ರತಿಕ್ರಿಯಿಸಿ. ಇವುಗಳಲ್ಲಿ ಯಾವುದಾದರೂ ಸಂಖ್ಯೆಯ ಆವೃತ್ತಿಯಲ್ಲಿ ನಿಯೋಜಿತ ಏಜೆಂಟ್ಗೆ ಮೌಲ್ಯಗಳನ್ನು ತುಂಬುತ್ತದೆ:
{"variables": {...}},{"context": "..."}, ಅಥವಾ ಎರಡೂ- ನಿಯೋಜಿತ ಏಜೆಂಟ್ನ ಐಡಿಗೆ
"agent_id"ಹೊಂದಿಸಿರುವ ಅದೇ ರೀತಿ {}: ಏಜೆಂಟ್ ಯಾವುದೇ ಮೌಲ್ಯಗಳನ್ನು ತುಂಬದೆ ಉತ್ತರಿಸುತ್ತದೆ
agent_id ಪಕ್ಕದಲ್ಲಿರುವಂತೆ timezone ಮತ್ತು language
ಸಹ ಅನುಮತಿಸಲ್ಪಟ್ಟಿವೆ. ವೇರಿಯಬಲ್ಗಳು ಏಜೆಂಟ್ನ {{placeholders}} ಅನ್ನು ತುಂಬುತ್ತವೆ;
ಸಂದರ್ಭವನ್ನು prompt ನಂತರ ಸೇರಿಸಲಾಗುತ್ತದೆ.
ಅಥವಾ ಕರೆಯನ್ನು ನೀವೇ ನಿರ್ಧರಿಸಿ. ಇನ್ನೊಂದು ಏಜೆಂಟ್ನ agent_id, ಅಥವಾ prompt ಹೊಂದಿರುವ
ಸಂಪೂರ್ಣ ಕಾನ್ಫಿಗರೇಶನ್, ನಿಯೋಜಿತ ಏಜೆಂಟ್ನ ಬದಲಿಗೆ (ಮತ್ತು ಅದರ ಪಿನ್ ಮಾಡಲಾದ ಆವೃತ್ತಿಯ ಬದಲಿಗೆ)
ಈ ಒಂದು ಕರೆಗೆ ಉತ್ತರಿಸುತ್ತದೆ. ಕರೆ ವಿವರಗಳು ಪ್ರತಿಯೊಂದು ಪ್ರಕರಣವನ್ನು
call_setup_webhook ನಲ್ಲಿ ಹೀಗೆ ಲೇಬಲ್ ಮಾಡುತ್ತವೆ: assigned_agent,
other_agent ಅಥವಾ inline_config. ಬಳಸಲಾಗದ ಉತ್ತರವು (ತಿಳಿದಿಲ್ಲದ agent_id,
variables ಪಕ್ಕದಲ್ಲಿರುವ ಇತರ ಕೀಗಳು, ಮೌಲ್ಯನಿರ್ಣಯದಲ್ಲಿ ವಿಫಲವಾಗುವ ಕಾನ್ಫಿಗರೇಶನ್) ಸಂಖ್ಯೆಯ
ವೆಬ್ಹುಕ್ನಂತೆಯೇ ಕರೆಯನ್ನು ಕೊನೆಗೊಳಿಸುತ್ತದೆ.
ವೆಬ್ಹುಕ್ ಯಾವಾಗ ಉತ್ತರಿಸಬೇಕು. ಏಜೆಂಟ್ನ ಸೆಟ್ಟಿಂಗ್ಗಳು ಡೀಫಾಲ್ಟ್ ಇಲ್ಲದ
{{variable}} ಅನ್ನು ಬಳಸಿದಾಗ ಏಜೆಂಟ್ಗೆ ಅದರ ವೆಬ್ಹುಕ್ ಅಗತ್ಯವಿರುತ್ತದೆ: ಅದರ prompt ಅಥವಾ
ಮರುಬಳಕೆ ಮಾಡಬಹುದಾದ ಸೂಚನೆಗಳು, ಹಂತದ ಸೂಚನೆಗಳು ಅಥವಾ ಸಾಲುಗಳು, ಸ್ವೀಕೃತಿ prompt, ಧ್ವನಿಮೇಲ್
ಸಂದೇಶ, ಸಮ್ಮತಿ ಘೋಷಣೆ, ಅಥವಾ {{variable}} ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆ. ಏಜೆಂಟ್ನ
call_setup_webhook_variables ಅವುಗಳನ್ನು ಪಟ್ಟಿ ಮಾಡುತ್ತದೆ.
- ಅದಕ್ಕೆ ವೆಬ್ಹುಕ್ ಅಗತ್ಯವಿದೆ: ವೆಬ್ಹುಕ್ ಕಾಲಮಿತಿಯನ್ನು ಮೀರಿದಾಗ, ತಲುಪಲು ಸಾಧ್ಯವಾಗದಾಗ,
ಅಥವಾ ದೋಷದೊಂದಿಗೆ ಅಥವಾ JSON ಆಬ್ಜೆಕ್ಟ್ ಅಲ್ಲದ ಬಾಡಿಯೊಂದಿಗೆ ಉತ್ತರಿಸಿದಾಗ, ಆ ವೇರಿಯಬಲ್ಗಳಲ್ಲಿ
ಒಂದಕ್ಕೆ ಕರೆಯು ಈಗಾಗಲೇ ಮೌಲ್ಯ ಹೊಂದಿದ್ದರೂ ಕರೆ ಪ್ರಾರಂಭವಾಗುವುದಿಲ್ಲ. ಅದನ್ನು ಕೊನೆಗೊಳಿಸಿ
ಕಾಲಮಿತಿಗಳು ಮತ್ತು ಮರುಪ್ರಯತ್ನಗಳು ನಲ್ಲಿ ವಿವರಿಸಿದಂತೆಯೇ
ದಾಖಲಿಸಲಾಗುತ್ತದೆ (
end_reasoninbound_config_webhook_failed, ಬಿಲ್ ವಿಧಿಸಲಾಗುವುದಿಲ್ಲ). - ಅದಕ್ಕೆ ಏನೂ ಅಗತ್ಯವಿಲ್ಲ (ವೇರಿಯಬಲ್ಗಳಿಲ್ಲ, ಅಥವಾ ಪ್ರತಿಯೊಂದಕ್ಕೂ
{{first_name|there}}ನಂತಹ ಡೀಫಾಲ್ಟ್ ಇದೆ): ವೆಬ್ಹುಕ್ ಇನ್ನೂ ಚಲಿಸುತ್ತದೆ, ಆದರೆ ಅದು ವಿಫಲವಾದಾಗ ಏಜೆಂಟ್ ಅದಿಲ್ಲದೆ ಉತ್ತರಿಸುತ್ತದೆ ಮತ್ತು ಕರೆ ವಿವರಗಳು ಏನು ತಪ್ಪಾಗಿದೆ ಎಂಬುದರೊಂದಿಗೆwebhook_failedಅನ್ನು ತೋರಿಸುತ್ತವೆ.
ಕರೆ ಸಂದರ್ಭ ಮಾತ್ರದಿಂದ ವೆಬ್ಹುಕ್ ಕಡ್ಡಾಯವಾಗುವುದಿಲ್ಲ: ಏಜೆಂಟ್ನ ಸೆಟ್ಟಿಂಗ್ಗಳಲ್ಲಿ ಅದಕ್ಕೆ ಸಂದರ್ಭ ಬೇಕು ಎಂದು ಯಾವುದೂ ಸೂಚಿಸುವುದಿಲ್ಲ. ನಿಮ್ಮ ವೆಬ್ಹುಕ್ನ ಉತ್ತರ ಇಲ್ಲದೆ ಕರೆ ಪ್ರಾರಂಭವಾಗಬಾರದೆಂದರೆ ಡೀಫಾಲ್ಟ್ ಇಲ್ಲದ ವೇರಿಯಬಲ್ ಬಳಸಿ.
ನಿಯೋಜಿಸುವುದು ಮತ್ತು ನಿಯೋಜನೆ. ತನ್ನ ವೆಬ್ಹುಕ್ ಅಗತ್ಯವಿರುವ ಏಜೆಂಟ್ ಅನ್ನು
ವೆಬ್ಹುಕ್ ಇಲ್ಲದ ಸಂಖ್ಯೆಗೆ ನಿಯೋಜಿಸಲಾಗುವುದಿಲ್ಲ: ವೇರಿಯಬಲ್ಗಳ ಹೆಸರನ್ನು ತಿಳಿಸುವ ಸಂದೇಶದೊಂದಿಗೆ ನಿಯೋಜನೆಯನ್ನು ನಿರಾಕರಿಸಲಾಗುತ್ತದೆ. ಪಿನ್ ಮಾಡಲಾದ ಸಂಖ್ಯೆಯು ಇತ್ತೀಚಿನ ಆವೃತ್ತಿಗೆ ಹಿಂದಿರುಗುವುದೂ ಸೇರಿದಂತೆ, ಸಂಖ್ಯೆಯ ಆವೃತ್ತಿ ಬದಲಾದಾಗಲೂ ಇದೇ ಪರಿಶೀಲನೆ ನಡೆಯುತ್ತದೆ. ಏಜೆಂಟ್ ತನ್ನ
ಪ್ರಕಟಿತ ಸೆಟ್ಟಿಂಗ್ಗಳೊಂದಿಗೆ ಸಂಖ್ಯೆಗೆ ಉತ್ತರಿಸುತ್ತಿರುವಾಗ, ವೆಬ್ಹುಕ್ ಇಲ್ಲದೆ ಅಂತಹ ವೇರಿಯಬಲ್ ಸೇರಿಸುವ
(ಅಥವಾ ವೆಬ್ಹುಕ್ ತೆಗೆದುಹಾಕುವ) ನಿಯೋಜನೆಯನ್ನು ಇದೇ ರೀತಿಯಲ್ಲಿ ನಿರಾಕರಿಸಲಾಗುತ್ತದೆ. ಕರಡನ್ನು ಉಳಿಸುವುದನ್ನು ಯಾವಾಗಲೂ ಅನುಮತಿಸಲಾಗುತ್ತದೆ, ಮತ್ತು ಸರಿಪಡಿಸುವವರೆಗೆ ಏಜೆಂಟ್ನ warnings ನಲ್ಲಿ
call_setup_webhook_needed ಇರುತ್ತದೆ.
ಏಜೆಂಟ್ನ ವೆಬ್ಹುಕ್ ಅದನ್ನು ನಿಯೋಜಿಸಲಾದ ಸಂಖ್ಯೆಗಳಲ್ಲಿನ ಒಳಬರುವ ಫೋನ್ ಕರೆಗಳಿಗೆ ಮಾತ್ರ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತದೆ. ಹೊರಹೋಗುವ ಕರೆಗಳು, ವೆಬ್ ವಿಜೆಟ್ ಸೆಷನ್ಗಳು, SIP ವಿಳಾಸಗಳು, ಸಿಮ್ಯುಲೇಷನ್ಗಳು ಮತ್ತು ಡ್ಯಾಶ್ಬೋರ್ಡ್ ಪರೀಕ್ಷಾ ಸಂಭಾಷಣೆಗಳು ಇದನ್ನು ಕರೆಯುವುದಿಲ್ಲ; ಅವು ಹಿಂದಿನಂತೆಯೇ ವಿನಂತಿಯಿಂದ ತಮ್ಮ ವೇರಿಯಬಲ್ಗಳನ್ನು ಪಡೆಯುತ್ತವೆ.
ಉಳಿಸಿದ ಮಾದರಿಗಳೊಂದಿಗೆ ಪರೀಕ್ಷೆ. ನಿರ್ದಿಷ್ಟ ಉತ್ತರದೊಂದಿಗೆ ನಿಮ್ಮ ಏಜೆಂಟ್ ಏನು ಮಾಡುತ್ತದೆ ಎಂಬುದನ್ನು ಪರೀಕ್ಷಿಸಲು
(ಮತ್ತೆ ಕರೆ ಮಾಡುವವರು, ಯಾವುದೇ ದಾಖಲೆ ದೊರೆಯದಿರುವುದು, ಸ್ಪ್ಯಾನಿಷ್ ಮಾತನಾಡುವವರು),
ಆ ಉತ್ತರವನ್ನು ಏಜೆಂಟ್ನಲ್ಲಿ ಮಾದರಿಯಾಗಿ ಉಳಿಸಿ: ಅದರ variables, context
ಮತ್ತು ಐಚ್ಛಿಕವಾಗಿ language, ಕೈಯಾರೆ ನಮೂದಿಸಿದ ಅಥವಾ ಹಿಂದಿನ ಕರೆಯಿಂದ ನಕಲಿಸಿದ ರೂಪದಲ್ಲಿ. ಅದನ್ನು
ನೀವು ಡ್ಯಾಶ್ಬೋರ್ಡ್ ಪರೀಕ್ಷಾ ಸಂಭಾಷಣೆ, ನಿಮ್ಮ ಫೋನ್ಗೆ ಪರೀಕ್ಷಾ ಕರೆ
ಅಥವಾ ಏಜೆಂಟ್ಗೆ ವಿರುದ್ಧದ ಸಿಮ್ಯುಲೇಶನ್ ಪ್ರಾರಂಭಿಸುವಾಗ ಆಯ್ಕೆಮಾಡಿ; ಆಗ ನಿಮ್ಮ ವೆಬ್ಹುಕ್
ಅದರಿಂದ ಉತ್ತರಿಸಿದಂತೆ ಕರೆ ನಡೆಯುತ್ತದೆ. ಮಾದರಿಗಳನ್ನು ಏಜೆಂಟ್ನ ಪ್ರತಿಯೊಂದು ಆವೃತ್ತಿಯೂ ಹಂಚಿಕೊಳ್ಳುತ್ತದೆ.
ಒಂದನ್ನು ಸಂಪಾದಿಸಿದರೂ ಅದರ ಹಿಂದಿನ ಆವೃತ್ತಿಗಳು ಉಳಿಯುತ್ತವೆ: ಏಜೆಂಟ್ ಬದಲಾವಣೆಗೆ
ಮಾದರಿ ಹೊಂದಿಸದ ವೇರಿಯಬಲ್ ಅಗತ್ಯವಾದಾಗ, ಅದನ್ನು ಮಾದರಿಗೆ ಸೇರಿಸಿ; ಹಳೆಯ ಏಜೆಂಟ್
ಆವೃತ್ತಿಗಳು ಮಾದರಿಯನ್ನು ಹಿಂದಿನಂತೆಯೇ ಬಳಸುತ್ತವೆ. ಫೋನ್ ಸಂಖ್ಯೆಗೆ ಡಯಲ್ ಮಾಡುವ ಸಿಮ್ಯುಲೇಶನ್ಗಳು ಬದಲಿಗೆ
ನಿಮ್ಮ ನಿಜವಾದ ವೆಬ್ಹುಕ್ ಅನ್ನು ಚಲಾಯಿಸುತ್ತವೆ.
ನಿಯೋಜಿತ ಏಜೆಂಟ್ ಇಲ್ಲದ ಸಂಖ್ಯೆಗಳು ಮೇಲಿನಂತೆಯೇ ಸಂಖ್ಯೆಯ ಅಥವಾ ಸಂಸ್ಥೆಯ ವೆಬ್ಹುಕ್ ಅನ್ನು ಬಳಸುತ್ತವೆ.
ಮರುಕರೆಗಳು
ಜನರು ತಮಗೆ ಕರೆ ಮಾಡಿದ ಸಂಖ್ಯೆಗೆ ಆಗಾಗ್ಗೆ ಮರುಕರೆ ಮಾಡುತ್ತಾರೆ, ಉದಾಹರಣೆಗೆ ನಿಮ್ಮ ಏಜೆಂಟ್ ವಾಯ್ಸ್ಮೇಲ್ ಬಿಟ್ಟ ನಂತರ. ಕಳೆದ 30 ದಿನಗಳಲ್ಲಿ ಅದೇ ಸಂಖ್ಯೆಗೆ ಕರೆ ಮಾಡಿದ ಯಾರೊಬ್ಬರಿಂದ ಫೋನ್ ಕರೆ ಬಂದಾಗ, ThunderPhone ಅಂತಹ ಇತ್ತೀಚಿನ ಹೊರಹೋಗುವ ಕರೆಯನ್ನು (ಅವರ ಫೋನ್ಗೆ ರಿಂಗ್ ಆದ ಕರೆಯನ್ನು) ಹುಡುಕಿ ಅದನ್ನು ಮೂರು ರೀತಿಯಲ್ಲಿ ಬಳಸುತ್ತದೆ:
-
ವಿನಂತಿಯಲ್ಲಿನ
returning_call. ಮೇಲಿನ ತಡೆಹಿಡಿಯುವ ವಿನಂತಿ ಮತ್ತು ಎಂಡ್ಪಾಯಿಂಟ್ ಅಧಿಸೂಚನೆ ಇದನ್ನು ಒಳಗೊಂಡಿರುತ್ತವೆ, ಆದ್ದರಿಂದ ನಿಮ್ಮ ಹ್ಯಾಂಡ್ಲರ್ ಕರೆಯುವವರನ್ನು ಮಾರ್ಗನಿರ್ದೇಶಿಸಬಹುದು:{ "type": "telephony.incoming", "data": { "call_id": 987654321, "from_number": "+14155550199", "to_number": "+15551234567", "returning_call": { "call_id": 987650001, "agent_id": 13, "started_at": "2026-10-21T19:05:12.402Z", "outcome": "voicemail" } } }ಕ್ಷೇತ್ರ ಪ್ರಕಾರ ವಿವರಣೆ call_idಪೂರ್ಣಾಂಕ ಹಿಂದಿನ ಹೊರಹೋಗುವ ಕರೆ agent_idಪೂರ್ಣಾಂಕ | null ಕರೆಯನ್ನು ಮಾಡಿದ ಏಜೆಂಟ್; ಇನ್ಲೈನ್ ಕಾನ್ಫಿಗ್ನೊಂದಿಗೆ ಮಾಡಿದ ಕರೆಗಾಗಿ ಅಥವಾ ಏಜೆಂಟ್ ಅಳಿಸಲ್ಪಟ್ಟಿದ್ದರೆ nullstarted_atಸ್ಟ್ರಿಂಗ್ ಅದು ಆರಂಭವಾದ ಸಮಯ (ISO 8601, UTC) outcomeಸ್ಟ್ರಿಂಗ್ no_answer(ರಿಂಗ್ ಆಗಿ ಅವಧಿ ಮುಗಿದಾಗ, ಬ್ಯುಸಿಯಾಗಿದ್ದಾಗ ಅಥವಾ ನಿರಾಕರಿಸಲ್ಪಟ್ಟಾಗ),voicemail(ವಾಯ್ಸ್ಮೇಲ್ ಉತ್ತರಿಸಿದಾಗ, ಅಥವಾ ಏಜೆಂಟ್ನೊಂದಿಗೆ ಯಾರೂ ಮಾತನಾಡದಿದ್ದಾಗ),conversation(ಯಾರಾದರೂ ಏಜೆಂಟ್ನೊಂದಿಗೆ ಮಾತನಾಡಿದಾಗ) ಅಥವಾanswered(ಕರೆ ಸ್ವೀಕರಿಸಿದಾಗ; ಯಾರು ಉತ್ತರಿಸಿದ್ದಾರೆ ಎಂಬುದು ಇನ್ನೂ ತಿಳಿದಿಲ್ಲ) -
ಏಜೆಂಟ್ಗೆ ಹಿನ್ನೆಲೆ. ಉತ್ತರಿಸುವ ಯಾವುದೇ ಏಜೆಂಟ್ ತನ್ನ prompt ನ ಕೊನೆಯಲ್ಲಿ ಒಂದು ಚಿಕ್ಕ ಟಿಪ್ಪಣಿಯನ್ನು ಪಡೆಯುತ್ತದೆ: ಹಿಂದಿನ ಕರೆಯನ್ನು ಯಾವಾಗ ಮಾಡಲಾಯಿತು, ಯಾವ ಏಜೆಂಟ್ ಮಾಡಿದರು ಮತ್ತು ಅದರ ಫಲಿತಾಂಶ. ಅದನ್ನು ಗಟ್ಟಿಯಾಗಿ ಓದಬಾರದೆಂದು ಏಜೆಂಟ್ಗೆ ಸೂಚಿಸಲಾಗುತ್ತದೆ ಮತ್ತು, ಕಾಲರ್ ಐಡಿ ನಕಲಿಯಾಗಿರಬಹುದಾದ ಕಾರಣ, ಈ ಹಿಂದೆ ಸಂಖ್ಯೆಗೆ ಕರೆ ಮಾಡಿರುವುದನ್ನು ಹೊರತುಪಡಿಸಿ ಆ ಕರೆಯ ಕುರಿತು ಯಾವುದೇ ವಿಷಯವನ್ನು ಹಂಚಿಕೊಳ್ಳಬಾರದೆಂದು ತಿಳಿಸಲಾಗುತ್ತದೆ.
-
ಪರ್ಯಾಯ ಏಜೆಂಟ್. ಸಂಖ್ಯೆಗೆ ಒಳಬರುವ ಏಜೆಂಟ್ ಇಲ್ಲದಿದ್ದಾಗ ಮತ್ತು ವೆಬ್ಹುಕ್ URL ಇಲ್ಲದ ಕಾರಣ ಅಥವಾ ನಿಮ್ಮ ವೆಬ್ಹುಕ್ ಯಾವುದೇ ಉತ್ತರ ನೀಡದ ಕಾರಣ ಕಾನ್ಫಿಗರೇಶನ್ ಬಾರದಿದ್ದರೆ (ಅದು ಕಾಲಾವಧಿ ಮೀರಿದರೆ, ತಲುಪಲಾಗದಿದ್ದರೆ, ಅಥವಾ ಎರಡೂ ಪ್ರಯತ್ನಗಳಲ್ಲಿ
5xx,408ಅಥವಾ429ಉತ್ತರಿಸಿದರೆ), ಕರೆ ಮುಗಿಯುವ ಬದಲು ಹಿಂದಿನ ಕರೆಯನ್ನು ಮಾಡಿದ ಏಜೆಂಟ್ಗೆ ಹೋಗುತ್ತದೆ, ಆ ಏಜೆಂಟ್ ನಿಮ್ಮ ಸಂಸ್ಥೆಯಲ್ಲಿ ಇನ್ನೂ ಇದ್ದರೆ. ಅದು ಆ ಏಜೆಂಟ್ನ ನಿಯೋಜಿತ ಸೆಟ್ಟಿಂಗ್ಗಳೊಂದಿಗೆ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತದೆ. ನಿಮ್ಮ ವೆಬ್ಹುಕ್ ನೀಡುವ ಯಾವುದೇ ಉತ್ತರವು ಇನ್ನೂ ನಿರ್ಧರಿಸುತ್ತದೆ: ಮತ್ತೊಂದು4xx, JSON ಆಬ್ಜೆಕ್ಟ್ ಅಲ್ಲದ ಬಾಡಿ,{}, ಅಥವಾ ಮೌಲ್ಯಮಾಪನದಲ್ಲಿ ವಿಫಲವಾಗುವ ಕಾನ್ಫಿಗ್ ಹಿಂದಿನಂತೆಯೇ ಕರೆಯನ್ನು ಮುಗಿಸುತ್ತದೆ. ಸಂಖ್ಯೆಯಲ್ಲಿರುವ ಒಳಬರುವ ಏಜೆಂಟ್ ಯಾವಾಗಲೂ ಉತ್ತರಿಸುತ್ತದೆ.
ಹಿಂದಿನ ಕರೆಯ ವಿವರಗಳನ್ನು ಹಂಚಿಕೊಳ್ಳುವುದು. ಕಾಲರ್ ಐಡಿ ನಕಲಿಯಾಗಿರಬಹುದು, ಆದ್ದರಿಂದ
ಪೂರ್ವನಿಯೋಜಿತವಾಗಿ ಹಿಂದಿನ ಕರೆಯ ವಿಷಯದಿಂದ ಯಾವುದೂ ಹೊಸ ಕರೆಗೆ ತಲುಪುವುದಿಲ್ಲ.
ಸಂಸ್ಥೆಯ ನಿರ್ವಾಹಕರು ಸಂಸ್ಥೆ → ಸಾಮಾನ್ಯ → ಮರುಕರೆಗಳು ಅಡಿಯಲ್ಲಿ ಹಿಂದಿನ ಕರೆಯ ವಿವರಗಳನ್ನು ಹಂಚಿಕೊಳ್ಳಿ
ಆನ್ ಮಾಡಬಹುದು (ಅಥವಾ
callback_context_details_enabled ಹೊಂದಿಸಬಹುದು).
ಇದು ಆನ್ ಆಗಿರುವಾಗ, ಏಜೆಂಟ್ನ ಟಿಪ್ಪಣಿಯು ಹಿಂದಿನ ಕರೆಯ ಸಾರಾಂಶವನ್ನೂ ಉಲ್ಲೇಖಿಸುತ್ತದೆ,
ಮತ್ತು ಹಿಂದಿನ ಕರೆಯನ್ನು ಮಾಡಿದ ಏಜೆಂಟ್ಗೆ ಮಾರ್ಗನಿರ್ದೇಶಿತವಾದ ಕರೆ ಆ ಕರೆಯ variables ನೊಂದಿಗೆ
(ಉದಾಹರಣೆಗೆ ಸಂಪರ್ಕದ ಹೆಸರು) ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತದೆ. ಆ ಸಂಖ್ಯೆಯಿಂದ ಕರೆ ಮಾಡುವ ಯಾರೊಂದಿಗೂ ಆ ವಿವರಗಳನ್ನು
ಹಂಚಿಕೊಳ್ಳುವುದು ಸುರಕ್ಷಿತವಾಗಿದ್ದರೆ ಮಾತ್ರ ಇದನ್ನು ಆನ್ ಮಾಡಿ. ಇದು ಆನ್ ಆಗಿದ್ದರೂ, ಸಂರಕ್ಷಿತ ಆರೋಗ್ಯ
ಮಾಹಿತಿಯನ್ನು ಒಳಗೊಂಡಿರಬಹುದಾದ ಕರೆ ತನ್ನ ಸಾರಾಂಶ ಅಥವಾ ವೇರಿಯಬಲ್ಗಳನ್ನು PHI ಪ್ರಕ್ರಿಯೆಗೊಳಿಸುವುದಾಗಿ
ಗೊತ್ತುಪಡಿಸದ ಕರೆಗೆ ಎಂದಿಗೂ ರವಾನಿಸುವುದಿಲ್ಲ.
ಕರೆ ವಿವರಗಳಲ್ಲಿ. ಹಿಂದಿನ ಕರೆಗೆ ಹೊಂದಿಕೆಯಾದ ಒಳಬರುವ ಕರೆಯು
GET /v1/calls/{call_id} ನಲ್ಲಿ callback ಆಬ್ಜೆಕ್ಟ್ ಹೊಂದಿರುತ್ತದೆ:
ಮೇಲಿನ returning_call, routed_as_callback (ಫಾಲ್ಬ್ಯಾಕ್ ಅದಕ್ಕೆ
ಉತ್ತರಿಸಿದೆಯೇ ಎಂಬುದು), ಮತ್ತು config_webhook_failure (ನಿಮ್ಮ ವೆಬ್ಹುಕ್ ಯಾವುದೇ ಉತ್ತರವನ್ನು ನೀಡದಿದ್ದಾಗ ಮತ್ತು ಫಾಲ್ಬ್ಯಾಕ್
ಕರೆಯನ್ನು ಸ್ವೀಕರಿಸಿದಾಗ {kind, attempts, http_status, host}, ಇಲ್ಲದಿದ್ದರೆ null), ಆದ್ದರಿಂದ
ಕರೆಗೆ ಉತ್ತರಿಸಲ್ಪಟ್ಟಿದ್ದರೂ ವೆಬ್ಹುಕ್ ಸ್ಥಗಿತವು ಗೋಚರವಾಗಿರುತ್ತದೆ.
ಪ್ರತಿಕ್ರಿಯೆ ಗಾತ್ರದ ಮಿತಿ
ಉದಾಹರಣೆ ಹ್ಯಾಂಡ್ಲರ್
import hashlib
import hmac
import json
import os
from fastapi import FastAPI, HTTPException, Request
app = FastAPI()
WEBHOOK_SECRET = os.environ["THUNDERPHONE_WEBHOOK_SECRET"]
def verify(body: bytes, signature: str) -> bool:
expected = hmac.new(WEBHOOK_SECRET.encode(), body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, signature or "")
@app.post("/thunderphone-webhook")
async def webhook(request: Request):
body = await request.body()
if not verify(body, request.headers.get("X-ThunderPhone-Signature", "")):
raise HTTPException(status_code=401)
event = json.loads(body)
if event["type"] == "telephony.incoming":
caller = event["data"]["from_number"]
prompt = (
"Greet the caller as a San Francisco local…"
if caller.startswith("+1415")
else "You are a friendly customer support agent…"
)
return {
"prompt": prompt,
"voice": "john",
"product": "spark",
}
if event["type"] == "web.incoming":
return {
"prompt": "You are the website's helpful voice assistant…",
"voice": "john",
"product": "spark",
}
return {}import crypto from "node:crypto";
import express from "express";
const app = express();
const SECRET = process.env.THUNDERPHONE_WEBHOOK_SECRET;
function verify(body, signature) {
const expected = crypto
.createHmac("sha256", SECRET)
.update(body)
.digest("hex");
return signature &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}
app.post(
"/thunderphone-webhook",
express.raw({ type: "application/json" }),
(req, res) => {
if (!verify(req.body, req.header("X-ThunderPhone-Signature"))) {
return res.sendStatus(401);
}
const event = JSON.parse(req.body.toString("utf8"));
if (event.type === "telephony.incoming" || event.type === "web.incoming") {
const caller = event.data.from_number || "web";
const prompt = caller.startsWith("+1415")
? "Greet the caller as a San Francisco local…"
: "You are a friendly customer support agent…";
return res.json({
prompt,
voice: "john",
product: "spark",
});
}
res.json({});
},
);ಫಂಕ್ಷನ್ ಟೂಲ್ಗಳೊಂದಿಗಿನ ಪ್ರತಿಕ್ರಿಯೆ
ಸಂಭಾಷಣೆಯ ಮಧ್ಯದಲ್ಲಿ AI ನಿಮ್ಮ APIಗಳನ್ನು ಕರೆಯಲು ಟೂಲ್ಗಳನ್ನು ಲಗತ್ತಿಸಿ:
{
"prompt": "You are a booking assistant. Use the available tools to help customers schedule appointments.",
"voice": "john",
"product": "spark",
"tools": [
{
"type": "function",
"function": {
"name": "search_appointments",
"description": "Find available appointment slots",
"parameters": {
"type": "object",
"properties": {
"date": { "type": "string", "description": "YYYY-MM-DD" },
"service": { "type": "string" }
},
"required": ["date"]
}
},
"endpoint": {
"url": "https://api.example.com/appointments/search",
"method": "POST",
"headers": {
"X-Api-Key": "your-key"
}
}
}
]
}ಸೆಟ್ಟಿಂಗ್ಗಳ ತ್ವರಿತ ಉಲ್ಲೇಖ
product: "bolt" ಕಳುಹಿಸಿ ಮತ್ತು ಈ ಕ್ಷೇತ್ರಗಳೊಂದಿಗೆ ಕರೆಯನ್ನು ಹೊಂದಿಸಿ. ಹಳೆಯ
product ಮೌಲ್ಯಗಳು (spark ಮತ್ತು storm-* ಮೌಲ್ಯಗಳು) ಇನ್ನೂ ಸ್ವೀಕರಿಸಲ್ಪಡುತ್ತವೆ.
| ಕ್ಷೇತ್ರ | ಮೌಲ್ಯಗಳು | ಇದು ಯಾವುದನ್ನು ಸಮತೋಲನಗೊಳಿಸುತ್ತದೆ |
|---|---|---|
intelligence | core, pro (ಡೀಫಾಲ್ಟ್) | ಕೋರ್ ಕಡಿಮೆ ವೆಚ್ಚದಾಗಿದೆ ಮತ್ತು ಬೇಗ ಪ್ರತಿಕ್ರಿಯಿಸಲು ಪ್ರಾರಂಭಿಸುತ್ತದೆ; ಪ್ರೊ ದೀರ್ಘ promptಗಳನ್ನು ಹೆಚ್ಚು ವಿಶ್ವಾಸಾರ್ಹವಾಗಿ ಅನುಸರಿಸುತ್ತದೆ |
audio_tier | lite, standard (ಡೀಫಾಲ್ಟ್), plus, max | ಹೆಚ್ಚಿನ ಹಂತಗಳು ಉತ್ತಮವಾಗಿ ಕೇಳುತ್ತವೆ ಮತ್ತು ಹೆಚ್ಚು ವೆಚ್ಚವಾಗುತ್ತವೆ; ಪ್ಲಸ್ ಕೆಲವು ಸರದಿಗಳಲ್ಲಿ 1–2 ಸೆಕೆಂಡುಗಳನ್ನು ಸೇರಿಸುತ್ತದೆ, ಪ್ರತಿ ಮ್ಯಾಕ್ಸ್ ಪ್ರತಿಕ್ರಿಯೆಗೆ 3–4 ಸೆಕೆಂಡುಗಳು ಬೇಕಾಗುತ್ತವೆ (ಮ್ಯಾಕ್ಸ್ ಸಾಮಾನ್ಯವಾಗಿ ಲಭ್ಯವಿಲ್ಲ) |
endpointing | faster, fast, normal (ಡೀಫಾಲ್ಟ್), patient | ಕಡಿಮೆ ಕಾಯುವಿಕೆಗಳು ಬೇಗ ಪ್ರತಿಕ್ರಿಯಿಸುತ್ತವೆ ಮತ್ತು ಹೆಚ್ಚು ವೆಚ್ಚವಾಗುತ್ತವೆ |
faster_replies | true (ಡೀಫಾಲ್ಟ್), false | ವೇಗ ಹೆಚ್ಚಳ: ಸ್ವಲ್ಪ ಹೆಚ್ಚಿನ ವೆಚ್ಚಕ್ಕೆ, ಪ್ರತಿಕ್ರಿಯೆಗಳು ಸ್ವಲ್ಪ ಬೇಗ ಬರುತ್ತವೆ |
ಸಂಬಂಧಿತ
ಕರೆಯ ಅಂತ್ಯದ ನಿರ್ಬಂಧಿಸದ ಈವೆಂಟ್.
tools[] ಗಾಗಿ ಸಂಪೂರ್ಣ JSON ಸ್ಕೀಮಾ ಮತ್ತು ಸಹಿ ಮಾಡಲಾದ ಎಂಡ್ಪಾಯಿಂಟ್ ಒಪ್ಪಂದ.
telephony.incoming / web.incoming ಗೆ ಹಲವಾರು URLಗಳನ್ನು ಸಬ್ಸ್ಕ್ರೈಬ್ ಮಾಡಿ.
ಪ್ರತಿ ಕರೆಗಾರರಿಗೆ promptಗಳು, ಟೂಲ್ಗಳು ಮತ್ತು A/B ಪರೀಕ್ಷೆಗಳ ಮಾದರಿಗಳು.