Open in
telephony.incoming / web.incoming
ਬਲਾਕਿੰਗ webhook ਜੋ ਇਨਬਾਊਂਡ ਕਾਲ ਦੀ ਸੰਰਚਨਾ ਨੂੰ ਰੀਅਲ ਟਾਈਮ ਵਿੱਚ ਢਾਲਦਾ ਹੈ।
ਜਦੋਂ ਇੱਕ ਇਨਬਾਊਂਡ ਫ਼ੋਨ ਕਾਲ ਉਸ ਨੰਬਰ 'ਤੇ ਪਹੁੰਚਦੀ ਹੈ ਜਿਸ ਲਈ ਕੋਈ ਏਜੰਟ ਅਸਾਈਨ ਨਹੀਂ
ਹੈ (ਤੁਹਾਡੀਆਂ ਆਊਟਬਾਊਂਡ ਕਾਲਾਂ ਦਾ ਜਵਾਬ ਦੇਣ ਵਾਲੇ ਕਾਲਰਾਂ ਲਈ ਕਾਲਬੈਕਸ ਵੇਖੋ), ਜਾਂ ਇੱਕ ਵੈੱਬ ਵਿਜੇਟ ਸੈਸ਼ਨ ਪਬਲਿਸ਼ ਕਰਨ ਯੋਗ ਕੀ 'ਤੇ
mode="webhook" ਵਿੱਚ ਸ਼ੁਰੂ ਹੁੰਦਾ ਹੈ, ਤਾਂ ThunderPhone ਤੁਹਾਡੇ
ਲੇਗੇਸੀ ਵੈੱਬਹੁੱਕ URL
ਨੂੰ ਇੱਕ ਬਲੌਕ ਕਰਨ ਵਾਲੀ telephony.incoming / web.incoming ਬੇਨਤੀ ਭੇਜਦਾ ਹੈ
ਅਤੇ ਕਨਫ਼ਿਗਰੇਸ਼ਨ ਜਵਾਬ ਦੀ ਉਡੀਕ ਕਰਦਾ ਹੈ: ਇੱਕ ਫ਼ੋਨ ਕਾਲ ਲਈ ਵੱਧ ਤੋਂ ਵੱਧ 13 ਸਕਿੰਟ,
ਜਿਸ ਵਿੱਚ ਇੱਕ ਰੀਟ੍ਰਾਈ ਸ਼ਾਮਲ ਹੈ, ਅਤੇ ਇੱਕ ਵਿਜੇਟ ਸੈਸ਼ਨ ਲਈ ਵੱਧ ਤੋਂ ਵੱਧ 10 ਸਕਿੰਟ
(ਟਾਈਮਆਉਟ ਅਤੇ ਰੀਟ੍ਰਾਈਜ਼ ਵੇਖੋ)। ਹਰ ਕਾਲ ਲਈ prompt, ਆਵਾਜ਼ ਅਤੇ ਟੂਲਾਂ ਨੂੰ ਗਤੀਸ਼ੀਲ ਤੌਰ 'ਤੇ ਚੁਣਨ ਲਈ ਇਸ
ਅਦਾਨ-ਪ੍ਰਦਾਨ ਦੀ ਵਰਤੋਂ ਕਰੋ — ਪੂਰੇ ਪੈਟਰਨ ਲਈ
ਗਤੀਸ਼ੀਲ ਕਾਲ ਕਨਫ਼ਿਗਰੇਸ਼ਨ ਗਾਈਡ ਵੇਖੋ।
ਕਿਸੇ ਏਜੰਟ ਨੂੰ ਸੌਂਪਿਆ ਗਿਆ ਨੰਬਰ ਉਸੇ ਏਜੰਟ ਨਾਲ ਜਵਾਬ ਦਿੰਦਾ ਹੈ। ਜਦੋਂ ਏਜੰਟ ਦਾ ਆਪਣਾ ਕਾਲ ਸੈਟਅੱਪ webhook ਹੁੰਦਾ ਹੈ, ਤਾਂ ਏਜੰਟ ਦੇ ਵੇਰੀਏਬਲਾਂ ਅਤੇ ਕਾਲ ਦੇ ਸੰਦਰਭ ਨੂੰ ਭਰਨ ਲਈ ਉਹੀ ਬਲੌਕਿੰਗ ਅਦਲਾ-ਬਦਲੀ ਪਹਿਲਾਂ ਏਜੰਟ ਦੇ 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; fields ਅਣਡਿੱਠੀਆਂ ਕੀਜ਼ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ, ਜਿਵੇਂ ਗਲਤ ਸਪੈਲਿੰਗ ਵਾਲਾ
agentId), 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 | ਪੂਰਨ ਅੰਕ | ਕਾਲ 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 ms), fast (300 ms), normal (500 ms, ਮੂਲ ਰੂਪ ਵਿੱਚ) ਜਾਂ patient (800 ms); null, normal ਦੇ ਸਮਾਨ ਹੈ। ਕਾਲਰ ਦੇ ਰੁਕਣ ਤੋਂ ਬਾਅਦ ਜਵਾਬ ਲਈ ਮਾਡਲ ਨੂੰ ਪੁੱਛਣ ਤੋਂ ਪਹਿਲਾਂ Bolt v2 ਏਜੰਟ ਕਿੰਨਾ ਸਮਾਂ ਉਡੀਕ ਕਰਦਾ ਹੈ। ਛੋਟੀ ਉਡੀਕ ਨਾਲ ਜਲਦੀ ਜਵਾਬ ਮਿਲ ਸਕਦਾ ਹੈ, ਪਰ ਇਸ ਨਾਲ ਵੱਧ ਬੇਨਤੀਆਂ ਭੇਜੀਆਂ ਜਾਂਦੀਆਂ ਹਨ ਜਿਨ੍ਹਾਂ ਨੂੰ ਕਾਲਰ ਦੇ ਅਗਲੇ ਸ਼ਬਦ ਪੁਰਾਣਾ ਕਰ ਦਿੰਦੇ ਹਨ, ਜਿਸ ਨਾਲ ਮਾਡਲ ਦੀ ਲਾਗਤ ਵਧਦੀ ਹੈ। ਹੋਰ ਉਤਪਾਦ ਇਸਨੂੰ ਅਣਡਿੱਠਾ ਕਰਦੇ ਹਨ |
eagerness | ਸਟ੍ਰਿੰਗ | ਨੱਲ | ਨਹੀਂ | ਅਪ੍ਰਚਲਿਤ: 19 ਅਕਤੂਬਰ, 2026 ਤੱਕ endpointing ਦਾ ਨਾਮ, ਅਜੇ ਵੀ ਪੜ੍ਹਿਆ ਜਾਂਦਾ ਹੈ। ਜਦੋਂ endpointing ਸੈਟ ਹੋਵੇ ਤਾਂ ਅਣਡਿੱਠਾ ਕੀਤਾ ਜਾਂਦਾ ਹੈ |
intelligence | ਸਟ੍ਰਿੰਗ | ਨੱਲ | ਨਹੀਂ | core ਜਾਂ pro (ਮੂਲ ਰੂਪ ਵਿੱਚ); null, pro ਦੇ ਸਮਾਨ ਹੈ। Bolt v2 ਪਾਈਪਲਾਈਨ ਉੱਤੇ bolt ਏਜੰਟ ਆਪਣੀਆਂ ਹਿਦਾਇਤਾਂ ਦੀ ਕਿੰਨੀ ਭਰੋਸੇਯੋਗਤਾ ਨਾਲ ਪਾਲਣਾ ਕਰਦਾ ਹੈ। core ਲਈ ਪਹਿਲੇ ਸ਼ਬਦ ਤੱਕ ~700 ms ਲੱਗਦੇ ਹਨ, ਇਹ ਸਭ ਤੋਂ ਸਸਤਾ ਅਤੇ ਥੋੜ੍ਹਾ ਘੱਟ ਭਰੋਸੇਯੋਗ ਹੈ (PHI ਵਜੋਂ ਸੰਭਾਲੀਆਂ ਜਾਣ ਵਾਲੀਆਂ ਕਾਲਾਂ ਵਿੱਚ ~900 ms ਅਤੇ ਘੱਟ ਭਰੋਸੇਯੋਗ); pro ਲਈ ~900 ms ਲੱਗਦੇ ਹਨ; ਕੋਰ ਦੇ ਉਹ ਜਵਾਬ ਜੋ ਸਿਰਫ਼ ਟੂਲ ਨੂੰ ਕਾਲ ਕਰਦੇ, ਪ੍ਰੋ ਨੂੰ ਸੌਂਪੇ ਜਾਂਦੇ ਹਨ। ਪੁਰਾਣੇ ਮੁੱਲ 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 ਦੀ ਉਚਾਰਨ ਡਿਕਸ਼ਨਰੀ ਵਰਤਦੀ ਹੈ, ਜਿੱਥੇ ਉਹ ਮੌਜੂਦ ਹੋਵੇ। ਫ਼ੋਨ ਅਤੇ ਵਿਜਿਟ ਕਾਲਾਂ ਲਈ ਕੰਮ ਕਰਦਾ ਹੈ। ਸਿਰਫ਼ ThunderPhone ਦੀਆਂ ਆਪਣੀਆਂ Cartesia ਵੌਇਸਾਂ ਉੱਤੇ ਲਾਗੂ ਹੁੰਦਾ ਹੈ, ਤੁਹਾਡੀ ਆਪਣੀ Cartesia API ਕੁੰਜੀ ਦੀਆਂ ਵੌਇਸਾਂ ਉੱਤੇ ਨਹੀਂ। 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 | ਸਟ੍ਰਿੰਗ | ਨਹੀਂ | ਇਸ ਕਾਲ ਲਈ IANA ਸਮਾਂ ਖੇਤਰ, ਜਿਵੇਂ America/Chicago। ਏਜੰਟ ਆਪਣਾ ਸਮਾਂ ਖੇਤਰ ਵਰਤਣ ਤੋਂ ਪਹਿਲਾਂ ਇਸ ਵਿੱਚ ਮਿਤੀ ਅਤੇ ਸਮਾਂ ਦੱਸਦਾ ਹੈ। agent_id ਦੇ ਨਾਲ ਵੀ ਮਨਜ਼ੂਰ ਹੈ। ਜੋ ਮੁੱਲ IANA ਖੇਤਰ ਨਹੀਂ ਹਨ, ਉਹਨਾਂ ਨੂੰ ਅਣਡਿੱਠਾ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। ਹਰ ਕਾਲ ਲਈ ਸਮਾਂ ਖੇਤਰ ਸੈਟ ਕਰੋ ਵੇਖੋ |
context | ਸਟ੍ਰਿੰਗ | ਨੱਲ | ਨਹੀਂ | ਇਸ ਕਾਲ ਲਈ ਮੁਕਤ-ਰੂਪ ਟੈਕਸਟ, ਜਿਵੇਂ ਤੁਹਾਡੇ ਸਿਸਟਮ ਵੱਲੋਂ ਇਕੱਠੇ ਕੀਤੇ ਨੋਟਸ, ਵੱਧ ਤੋਂ ਵੱਧ 20,000 ਅੱਖਰ। prompt ਤੋਂ ਬਾਅਦ ਇੱਕ ਸੀਮਾਂਕਿਤ ਬਲਾਕ ਵਿੱਚ ਜੋੜਿਆ ਜਾਂਦਾ ਹੈ ਅਤੇ ਟੈਂਪਲੇਟ ਵਜੋਂ ਰੈਂਡਰ ਨਹੀਂ ਕੀਤਾ ਜਾਂਦਾ। agent_id ਦੇ ਨਾਲ ਵੀ ਮਨਜ਼ੂਰ ਹੈ। ਜੋ ਮੁੱਲ ਸਟ੍ਰਿੰਗ ਨਹੀਂ ਹੈ, ਜਾਂ ਲੰਮਾ ਹੈ, ਉਹ ਕਾਲ ਨੂੰ ਰੱਦ ਕਰਦਾ ਹੈ। ਕਾਲ ਵੇਰੀਏਬਲ ਅਤੇ ਕੌਂਟੈਕਸਟ ਵੇਖੋ |
call_id | ਇੰਟੀਜਰ | ਨਹੀਂ | ਬੇਨਤੀ ਦੀ ਕਾਲ ਆਈਡੀ ਦਾ ਵਿਕਲਪੀ ਈਕੋ; ਅਣਡਿੱਠਾ ਕੀਤਾ ਜਾਂਦਾ ਹੈ |
ਕਿਉਂਕਿ prompt ਅਤੇ voice ਲਾਜ਼ਮੀ ਹਨ, ਇਸ ਲਈ {} ਜਾਂ ਤਸਦੀਕ ਵਿੱਚ ਅਸਫਲ ਹੋਣ ਵਾਲਾ ਕੋਈ ਵੀ ਜਵਾਬ ਵਾਪਸ ਕਰਨ ਨਾਲ ਕਾਲ ਅਸਵੀਕਾਰ ਹੋ ਜਾਂਦੀ ਹੈ: ਫ਼ੋਨ ਕਾਲ ਟਾਈਮਆਉਟ ਅਤੇ ਮੁੜ ਕੋਸ਼ਿਸ਼ਾਂ ਵਿੱਚ ਦੱਸੇ ਅਨੁਸਾਰ ਸਮਾਪਤ ਹੋ ਜਾਂਦੀ ਹੈ, ਅਤੇ ਵਿਜਿਟ ਸੈਸ਼ਨ ਬੇਨਤੀ 422 ਨਾਲ ਅਸਫਲ ਹੁੰਦੀ ਹੈ। ਇਹ ਵਾਪਸ ਕਾਲ ਕਰਨ ਵਾਲਿਆਂ ਲਈ ਵੀ ਲਾਗੂ ਹੁੰਦਾ ਹੈ: ਤੁਹਾਡਾ webhook ਜੋ ਵੀ JSON ਆਬਜੈਕਟ ਵਾਪਸ ਕਰਦਾ ਹੈ, ਉਹੀ ਉਸਦਾ ਜਵਾਬ ਹੁੰਦਾ ਹੈ, ਅਤੇ {} ਕਾਲ ਅਸਵੀਕਾਰ ਕਰਨ ਦਾ ਤਰੀਕਾ ਹੈ।
ਏਜੰਟ ਕਾਲ ਸੈਟਅੱਪ ਵੈੱਬਹੁੱਕ
ਕਿਸੇ ਏਜੰਟ ਦਾ ਆਪਣਾ ਕਾਲ ਸੈਟਅੱਪ ਵੈੱਬਹੁੱਕ ਹੋ ਸਕਦਾ ਹੈ: ਇਸ ਦੀਆਂ ਸੈਟਿੰਗਾਂ ਵਿੱਚ
ਕਾਲ ਸੈਟਅੱਪ ਵੈੱਬਹੁੱਕ ਫ਼ੀਲਡ, ਜਾਂ API ਵਿੱਚ
call_setup_webhook_url। ਏਜੰਟ ਨੂੰ ਕਿਸੇ ਨੰਬਰ ਨਾਲ ਅਸਾਈਨ ਕਰੋ, ਅਤੇ
ਉਸ ਨੰਬਰ 'ਤੇ ਏਜੰਟ ਦੁਆਰਾ ਜਵਾਬ ਦਿੱਤੀ ਜਾਣ ਵਾਲੀ ਹਰੇਕ ਆਉਣ ਵਾਲੀ ਕਾਲ ਤੋਂ ਪਹਿਲਾਂ,
ThunderPhone ਉਸ ਕਾਲ ਦੇ ਵੇਰੀਏਬਲਾਂ ਅਤੇ ਸੰਦਰਭ ਲਈ ਵੈੱਬਹੁੱਕ ਨੂੰ ਪੁੱਛਦਾ ਹੈ। ਨੰਬਰ ਆਪਣੇ
ਏਜੰਟ ਨੂੰ ਰੱਖਦਾ ਹੈ, ਇਸ ਲਈ ਫ਼ੋਨ ਨੰਬਰਾਂ ਦਾ ਪੰਨਾ ਅਤੇ ਏਜੰਟ ਪੰਨਾ ਦਿਖਾਉਂਦੇ ਹਨ ਕਿ ਉਸਦਾ ਜਵਾਬ ਕਿਹੜਾ ਏਜੰਟ ਦਿੰਦਾ ਹੈ।
ਇਹ ਏਜੰਟ ਦੀਆਂ ਹੋਰ ਸੈਟਿੰਗਾਂ ਵਾਂਗ ਹੀ ਇੱਕ ਸੈਟਿੰਗ ਹੈ: ਡਰਾਫਟ ਵਜੋਂ ਤਿਆਰ ਕੀਤੀ ਜਾਂਦੀ ਹੈ,
ਡਿਪਲੌਇ ਕਰਨ 'ਤੇ ਪ੍ਰਕਾਸ਼ਿਤ ਹੁੰਦੀ ਹੈ ਅਤੇ ਵਰਜਨ ਇਤਿਹਾਸ ਵਿੱਚ ਰੱਖੀ ਜਾਂਦੀ ਹੈ। ਕੋਈ ਨੰਬਰ ਜੋ
ਪੁਰਾਣੇ ਵਰਜਨ ਨਾਲ ਪਿੰਨ ਕੀਤਾ ਹੋਇਆ ਹੈ
ਉਸ ਵਰਜਨ ਦਾ URL ਪੁੱਛਦਾ ਹੈ। ਬੇਨਤੀਆਂ ਏਜੰਟ ਦੇ ਆਪਣੇ
call_setup_webhook_signing_secret ਨਾਲ ਸਾਈਨ ਹੁੰਦੀਆਂ ਹਨ (ਸੰਸਥਾ ਦੇ ਵੈੱਬਹੁੱਕ
ਸੀਕ੍ਰੇਟ ਨਾਲ ਨਹੀਂ), ਅਤੇ ਉਹੀ X-ThunderPhone-Signature ਹੈਡਰ, ਟਾਈਮਆਉਟ,
ਰੀਟ੍ਰਾਈ ਅਤੇ idempotency ਕੁੰਜੀ ਵਰਤਦੀਆਂ ਹਨ ਜੋ ਉੱਪਰ ਹਨ। ਸੀਕ੍ਰੇਟ
ਸਿਰਫ਼ ਲਿਖਣ-ਯੋਗ ਹੈ: ਉਹ ਸੈਟ ਕਰੋ ਜਿਸਦੀ ਤੁਹਾਡਾ ਐਂਡਪੌਇੰਟ ਜਾਂਚ ਕਰਦਾ ਹੈ (ਏਜੰਟ ਦੀਆਂ ਸੈਟਿੰਗਾਂ ਵਿੱਚ, ਜਾਂ
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"ਨੂੰ ਅਸਾਈਨ ਕੀਤੇ ਏਜੰਟ ਦੀ id 'ਤੇ ਸੈਟ ਕੀਤਾ ਹੋਵੇ {}: ਏਜੰਟ ਬਿਨਾਂ ਕੁਝ ਭਰੇ ਜਵਾਬ ਦਿੰਦਾ ਹੈ
timezone ਅਤੇ language ਦੀ ਵੀ ਇਜਾਜ਼ਤ ਹੈ, ਜਿਵੇਂ
agent_id ਦੇ ਅੱਗੇ ਹੈ। ਵੇਰੀਏਬਲ ਏਜੰਟ ਦੇ
{{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 ਦੇ ਅੰਤ ਵਿੱਚ ਇੱਕ ਛੋਟਾ ਨੋਟ ਮਿਲਦਾ ਹੈ: ਪਹਿਲੀ ਕਾਲ ਕਦੋਂ ਕੀਤੀ ਗਈ ਸੀ, ਕਿਸ ਏਜੰਟ ਨੇ ਕੀਤੀ ਸੀ ਅਤੇ ਇਸਦਾ ਨਤੀਜਾ ਕੀ ਸੀ। ਏਜੰਟ ਨੂੰ ਇਸਨੂੰ ਉੱਚੀ ਆਵਾਜ਼ ਵਿੱਚ ਨਾ ਪੜ੍ਹਨ ਲਈ ਕਿਹਾ ਜਾਂਦਾ ਹੈ ਅਤੇ, ਕਿਉਂਕਿ ਕਾਲਰ ID ਜਾਅਲੀ ਹੋ ਸਕਦੀ ਹੈ, ਉਸ ਨੰਬਰ 'ਤੇ ਪਹਿਲਾਂ ਕਾਲ ਕੀਤੇ ਜਾਣ ਤੋਂ ਇਲਾਵਾ ਉਸ ਕਾਲ ਬਾਰੇ ਕੁਝ ਵੀ ਸਾਂਝਾ ਨਾ ਕਰਨ ਲਈ ਕਿਹਾ ਜਾਂਦਾ ਹੈ।
-
ਇੱਕ ਬੈਕਅੱਪ ਏਜੰਟ। ਜਦੋਂ ਨੰਬਰ ਲਈ ਕੋਈ ਆਉਣ ਵਾਲੀਆਂ ਕਾਲਾਂ ਦਾ ਏਜੰਟ ਨਹੀਂ ਹੁੰਦਾ ਅਤੇ ਕੋਈ ਸੰਰਚਨਾ ਨਹੀਂ ਮਿਲਦੀ ਕਿਉਂਕਿ ਕੋਈ ਵੈੱਬਹੁੱਕ URL ਨਹੀਂ ਹੈ ਜਾਂ ਤੁਹਾਡੇ ਵੈੱਬਹੁੱਕ ਨੇ ਕੋਈ ਜਵਾਬ ਨਹੀਂ ਦਿੱਤਾ (ਇਸਦਾ ਸਮਾਂ ਸਮਾਪਤ ਹੋ ਗਿਆ, ਇਸ ਤੱਕ ਪਹੁੰਚ ਨਹੀਂ ਹੋ ਸਕੀ, ਜਾਂ ਦੋਵੇਂ ਕੋਸ਼ਿਸ਼ਾਂ ਵਿੱਚ
5xx,408ਜਾਂ429ਦਾ ਜਵਾਬ ਦਿੱਤਾ), ਤਾਂ ਕਾਲ ਖਤਮ ਕਰਨ ਦੀ ਬਜਾਏ ਉਸ ਏਜੰਟ ਕੋਲ ਜਾਂਦੀ ਹੈ ਜਿਸ ਨੇ ਪਹਿਲੀ ਕਾਲ ਕੀਤੀ ਸੀ, ਬਸ਼ਰਤੇ ਉਹ ਏਜੰਟ ਅਜੇ ਵੀ ਤੁਹਾਡੇ ਸੰਗਠਨ ਵਿੱਚ ਮੌਜੂਦ ਹੋਵੇ। ਇਹ ਉਸ ਏਜੰਟ ਦੀਆਂ ਤਾਇਨਾਤ ਸੈਟਿੰਗਾਂ ਨਾਲ ਚਲਦੀ ਹੈ। ਤੁਹਾਡਾ ਵੈੱਬਹੁੱਕ ਜੋ ਵੀ ਜਵਾਬ ਦੇਵੇ, ਉਹ ਫਿਰ ਵੀ ਫ਼ੈਸਲਾ ਕਰਦਾ ਹੈ: ਕੋਈ ਹੋਰ4xx, ਉਹ ਬਾਡੀ ਜੋ JSON ਆਬਜੈਕਟ ਨਹੀਂ ਹੈ,{}, ਜਾਂ ਪ੍ਰਮਾਣਿਕਤਾ ਜਾਂਚ ਵਿੱਚ ਅਸਫਲ ਸੰਰਚਨਾ ਪਹਿਲਾਂ ਵਾਂਗ ਕਾਲ ਖਤਮ ਕਰ ਦਿੰਦੀ ਹੈ। ਨੰਬਰ ਲਈ ਆਉਣ ਵਾਲੀਆਂ ਕਾਲਾਂ ਦਾ ਏਜੰਟ ਹਮੇਸ਼ਾ ਜਵਾਬ ਦਿੰਦਾ ਹੈ।
ਪਹਿਲੀ ਕਾਲ ਦੇ ਵੇਰਵੇ ਸਾਂਝੇ ਕਰਨਾ। ਕਾਲਰ ID ਜਾਅਲੀ ਹੋ ਸਕਦੀ ਹੈ, ਇਸ ਲਈ ਡਿਫੌਲਟ ਰੂਪ ਵਿੱਚ ਪਹਿਲੀ ਕਾਲ ਦੀ ਸਮੱਗਰੀ ਵਿੱਚੋਂ ਕੁਝ ਵੀ ਨਵੀਂ ਕਾਲ ਤੱਕ ਨਹੀਂ ਪਹੁੰਚਦਾ। ਸੰਗਠਨ ਦਾ ਐਡਮਿਨ ਸੰਗਠਨ → ਆਮ → ਵਾਪਸੀ ਕਾਲਾਂ ਹੇਠਾਂ ਪਹਿਲੀ ਕਾਲ ਦੇ ਵੇਰਵੇ ਸਾਂਝੇ ਕਰੋ ਨੂੰ ਚਾਲੂ ਕਰ ਸਕਦਾ ਹੈ (ਜਾਂ callback_context_details_enabled ਸੈੱਟ ਕਰ ਸਕਦਾ ਹੈ)। ਇਸਨੂੰ ਚਾਲੂ ਕਰਨ 'ਤੇ, ਏਜੰਟ ਦੇ ਨੋਟ ਵਿੱਚ ਪਹਿਲੀ ਕਾਲ ਦਾ ਸਾਰ ਵੀ ਹਵਾਲੇ ਵਜੋਂ ਸ਼ਾਮਲ ਹੁੰਦਾ ਹੈ ਅਤੇ ਪਹਿਲੀ ਕਾਲ ਕਰਨ ਵਾਲੇ ਏਜੰਟ ਕੋਲ ਰੂਟ ਕੀਤੀ ਕਾਲ ਉਸ ਕਾਲ ਦੇ variables (ਜਿਵੇਂ ਕਿ ਕਿਸੇ ਸੰਪਰਕ ਦਾ ਨਾਮ) ਨਾਲ ਚਲਦੀ ਹੈ। ਇਸਨੂੰ ਕੇਵਲ ਤਾਂ ਹੀ ਚਾਲੂ ਕਰੋ ਜੇ ਉਹ ਵੇਰਵੇ ਉਸ ਨੰਬਰ ਤੋਂ ਕਾਲ ਕਰਨ ਵਾਲੇ ਕਿਸੇ ਵੀ ਵਿਅਕਤੀ ਨਾਲ ਸਾਂਝੇ ਕਰਨਾ ਸੁਰੱਖਿਅਤ ਹੋਵੇ। ਇਸਨੂੰ ਚਾਲੂ ਕਰਨ ਦੇ ਬਾਵਜੂਦ, ਸੁਰੱਖਿਅਤ ਸਿਹਤ ਜਾਣਕਾਰੀ ਵਾਲੀ ਹੋ ਸਕਣ ਵਾਲੀ ਕਾਲ ਕਦੇ ਵੀ ਆਪਣਾ ਸਾਰ ਜਾਂ 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 (ਮੂਲ) | Core ਘੱਟ ਮਹਿੰਗਾ ਹੈ ਅਤੇ ਜਲਦੀ ਜਵਾਬ ਦੇਣਾ ਸ਼ੁਰੂ ਕਰਦਾ ਹੈ; Pro ਲੰਮੇ prompt ਦੀ ਵਧੇਰੇ ਭਰੋਸੇਯੋਗ ਤਰੀਕੇ ਨਾਲ ਪਾਲਣਾ ਕਰਦਾ ਹੈ |
audio_tier | lite, standard (ਮੂਲ), plus, max | ਉੱਚੇ ਟੀਅਰ ਬਿਹਤਰ ਸੁਣਦੇ ਹਨ ਅਤੇ ਵੱਧ ਖਰਚ ਹੁੰਦੇ ਹਨ; Plus ਕੁਝ ਵਾਰੀਆਂ ਵਿੱਚ 1–2 ਸਕਿੰਟ ਜੋੜਦਾ ਹੈ, ਹਰ Max ਜਵਾਬ ਨੂੰ 3–4 ਸਕਿੰਟ ਲੱਗਦੇ ਹਨ (Max ਆਮ ਤੌਰ 'ਤੇ ਉਪਲਬਧ ਨਹੀਂ ਹੈ) |
endpointing | faster, fast, normal (ਮੂਲ), patient | ਘੱਟ ਉਡੀਕ ਨਾਲ ਜਵਾਬ ਜਲਦੀ ਮਿਲਦਾ ਹੈ ਅਤੇ ਖਰਚ ਵੱਧ ਹੁੰਦਾ ਹੈ |
faster_replies | true (ਮੂਲ), false | ਗਤੀ ਵਾਧਾ: ਥੋੜ੍ਹੇ ਵੱਧ ਖਰਚ ਲਈ ਜਵਾਬ ਥੋੜ੍ਹਾ ਜਲਦੀ ਮਿਲਦਾ ਹੈ |