ThunderPhone v3 ਹੁਣ ਲਾਈਵ ਹੈ।ਸੈਲਫ਼-ਸਰਵਿਸ—2¢/ਮਿੰਟ ਤੋਂ।ਐਲਾਨ ਪੜ੍ਹੋ

Developer cookbook

ਹਰ ਕਾਲ ਲਈ ਵੇਰੀਏਬਲ ਅਤੇ ਸੰਦਰਭ

ਏਜੰਟ ਨੂੰ ਬਦਲੇ ਬਿਨਾਂ, ਹਰ ਕਾਲ ਲਈ ਉਸਦੇ ਆਪਣੇ ਵੇਰਵੇ ਦਿਓ—prompt ਲਈ ਨਾਮਿਤ ਵੇਰੀਏਬਲਾਂ ਜਾਂ ਮੁਕਤ-ਰੂਪ ਬ੍ਰੀਫ਼ ਵਜੋਂ।

ਹਰ ਕਾਲ ਵਿੱਚ ਕਾਲ-ਵਿਸ਼ੇਸ਼ ਇਨਪੁਟ ਦੀਆਂ ਦੋ ਕਿਸਮਾਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਇੱਕ ਵਰਤੋ ਜਾਂ ਦੋਵੇਂ ਇਕੱਠੇ ਵਰਤੋ:

  • variables: ਨਾਮ ਵਾਲੇ ਮੁੱਲ ਜੋ prompt ਵਿੱਚ {{placeholders}} ਨੂੰ ਭਰਦੇ ਹਨ। ਇਹਨਾਂ ਨੂੰ ਉਹਨਾਂ ਫ਼ੀਲਡਾਂ ਲਈ ਵਰਤੋ ਜਿਨ੍ਹਾਂ ਦਾ prompt ਨਾਮ ਨਾਲ ਹਵਾਲਾ ਦਿੰਦਾ ਹੈ, ਜਿਵੇਂ ਕਾਲਰ ਦਾ ਨਾਮ, ਖਾਤਾ ਨੰਬਰ ਜਾਂ ਮੁਲਾਕਾਤ ਦਾ ਸਮਾਂ।
  • context: prompt ਤੋਂ ਬਾਅਦ ਜੋੜਿਆ ਜਾਣ ਵਾਲਾ ਮੁਕਤ-ਰੂਪ ਟੈਕਸਟ। ਇਸਨੂੰ ਉਸ ਸੰਖੇਪ ਵੇਰਵੇ ਲਈ ਵਰਤੋ ਜੋ ਟੈਂਪਲੇਟ ਵਿੱਚ ਫਿੱਟ ਨਹੀਂ ਹੁੰਦਾ, ਜਿਵੇਂ ਇਸ ਕਾਲ ਲਈ ਕੰਮ ਦਾ ਵੇਰਵਾ ਜਾਂ ਪਹਿਲਾਂ ਇਕੱਠੇ ਕੀਤੇ ਨੋਟਸ।

ਹੇਠਾਂ ਵਰਣਿਤ ਕਾਲ ਸ਼ੁਰੂ ਕਰਨ ਦੇ ਹਰ ਤਰੀਕੇ ਵਿੱਚ, ਦੋਵੇਂ ਸੇਵ ਕੀਤੇ ਏਜੰਟ ਅਤੇ ਇਨਲਾਈਨ ਕਨਫ਼ਿਗਰੇਸ਼ਨ ਨਾਲ ਕੰਮ ਕਰਦੇ ਹਨ। ਕੋਈ ਵੀ ਸੇਵ ਕੀਤੇ ਏਜੰਟ, ਉਸਦੇ ਵਰਜਨ ਇਤਿਹਾਸ ਜਾਂ ਉਸ ਦੀਆਂ ਹੋਰ ਸੈਟਿੰਗਾਂ ਨੂੰ ਨਹੀਂ ਬਦਲਦਾ।

{
  "agent_id": 12,
  "variables": {"name": "Ada", "appointment_slot": "Tuesday at 10 AM"},
  "context": "Ada rescheduled twice last month. She prefers mornings and asked us not to call her work number."
}

ਵੇਰੀਏਬਲ

ਆਪਣੇ ਸੇਵ ਕੀਤੇ ਏਜੰਟ ਦੇ prompt ਵਿੱਚ ਪਲੇਸਹੋਲਡਰ ਰੱਖੋ, ਫਿਰ ਕਾਲ ਸ਼ੁਰੂ ਕਰਦੇ ਸਮੇਂ variables ਆਬਜੈਕਟ ਦਿਓ। ThunderPhone ਵੌਇਸ ਰਨਟਾਈਮ ਨੂੰ ਕਾਲ ਕੌਂਫਿਗਰੇਸ਼ਨ ਭੇਜਣ ਤੋਂ ਪਹਿਲਾਂ ਟੈਕਸਟ ਰੈਂਡਰ ਕਰਦਾ ਹੈ।

ਜਦੋਂ ਕਿਸੇ ਮੁੱਲ ਦੀ ਲੋੜ ਨਾ ਹੋਵੇ, variables ਛੱਡ ਦਿਓ, null ਨਾ ਭੇਜੋ (400 ਨਾਲ ਅਸਵੀਕਾਰ ਕੀਤਾ ਜਾਂਦਾ ਹੈ)।

ਪਲੇਸਹੋਲਡਰ ਅਤੇ ਡਿਫਾਲਟ

You are calling {{name|Friend}} about account {{account_id}}.
The available appointment is {{ appointment_slot }}.

ਨਾਂ ਕੇਸ-ਸੰਵੇਦਨਸ਼ੀਲ ਹੁੰਦੇ ਹਨ ਅਤੇ [A-Za-z_][A-Za-z0-9_]* ਦਾ ਪਾਲਣ ਕਰਦੇ ਹਨ। ਨਾਂ ਦੇ ਆਲੇ-ਦੁਆਲੇ ਖਾਲੀ ਥਾਂ ਦੀ ਇਜਾਜ਼ਤ ਹੈ; | ਤੋਂ ਬਾਅਦ ਦੀ ਖਾਲੀ ਥਾਂ ਡਿਫਾਲਟ ਦਾ ਹਿੱਸਾ ਹੁੰਦੀ ਹੈ ਅਤੇ ਸੰਭਾਲੀ ਜਾਂਦੀ ਹੈ। ਜਦੋਂ name ਮੌਜੂਦ ਨਾ ਹੋਵੇ ਜਾਂ null ਹੋਵੇ ਤਾਂ {{name|Friend}}, Friend ਵਰਤਦਾ ਹੈ; ਖਾਲੀ ਸਟਰਿੰਗ ਸਪਸ਼ਟ ਤੌਰ 'ਤੇ ਦਿੱਤਾ ਗਿਆ ਮੁੱਲ ਹੈ। ਡਿਫਾਲਟ ਤੋਂ ਬਿਨਾਂ ਗੁੰਮ ਮੁੱਲ ਖਾਲੀ ਸਟਰਿੰਗ ਬਣ ਜਾਂਦੇ ਹਨ ਅਤੇ ਉਨ੍ਹਾਂ ਦੇ ਨਾਂ unresolved_variables ਵਿੱਚ ਦਿਖਾਈ ਦਿੰਦੇ ਹਨ। ਦੋਹਰੇ ਬਰੇਸਾਂ ਦੇ ਵਿਚਕਾਰ ਵਾਲਾ ਟੈਕਸਟ ਜੋ ਵੈਧ ਪਲੇਸਹੋਲਡਰ ਨਹੀਂ ਹੈ, ਹਟਾ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ। ਦੋਹਰੇ ਬਰੇਸਾਂ ਵਾਲਾ ਟੈਕਸਟ ਹਰ ਦਿੱਤੇ ਗਏ ਮੁੱਲ ਦੇ ਅੰਦਰ ਸੁਤੰਤਰ ਤੌਰ 'ਤੇ ਹਟਾਇਆ ਜਾਂਦਾ ਹੈ; ਕੋਈ ਮੁੱਲ ਆਲੇ-ਦੁਆਲੇ ਦੇ prompt ਟੈਕਸਟ ਜਾਂ ਕਿਸੇ ਹੋਰ ਮੁੱਲ ਨੂੰ ਹਟਾ ਨਹੀਂ ਸਕਦਾ। ਬੇਜੋੜ ਦੋਹਰੇ-ਬਰੇਸ ਡਿਲਿਮਟਰ ਵੀ ਹਟਾ ਦਿੱਤੇ ਜਾਂਦੇ ਹਨ। prompt ਵਿੱਚ JSON ਉਦਾਹਰਨਾਂ ਵਿੱਚ {{ ਨਹੀਂ ਵਰਤਣਾ ਚਾਹੀਦਾ। ਮੁੱਲ ਸਾਦਾ ਟੈਕਸਟ ਹੁੰਦੇ ਹਨ, ਕਦੇ ਵੀ ਕੋਡ ਵਜੋਂ ਮੁਲਾਂਕਣ ਨਹੀਂ ਕੀਤੇ ਜਾਂਦੇ ਨਾ ਹੀ ਟੈਂਪਲੇਟਾਂ ਵਜੋਂ ਰਿਕਰਸਿਵ ਤੌਰ 'ਤੇ ਫੈਲਾਏ ਜਾਂਦੇ ਹਨ।

ਵੇਰੀਏਬਲ ਪੁਸ਼ਟੀਕਰਨ promptਾਂ, ਆਊਟਬਾਊਂਡ ਵੌਇਸਮੇਲ ਸੁਨੇਹਿਆਂ ਅਤੇ ਸਹਿਮਤੀ ਘੋਸ਼ਣਾ ਟੈਕਸਟ ਵਿੱਚ ਵੀ ਦਿਖਾਈ ਦੇ ਸਕਦੇ ਹਨ ਜਦੋਂ ਉਹ ਫੀਲਡ ਫੋਨ ਕਾਲ ਲਈ ਭੇਜਿਆ ਜਾਂਦਾ ਹੈ। ਏਜੰਟ ਕੋਲ ਵੱਖਰਾ first_message ਫੀਲਡ ਨਹੀਂ ਹੈ: ਇਸ ਦੀਆਂ ਸ਼ੁਰੂਆਤੀ ਹਦਾਇਤਾਂ prompt ਵਿੱਚ ਰੱਖੋ। ਮੌਜੂਦਾ ਵੌਇਸਮੇਲ {agent_name} ਅਤੇ {org_name} ਪਲੇਸਹੋਲਡਰ ਕੰਮ ਕਰਦੇ ਰਹਿੰਦੇ ਹਨ।

ਮੁੱਲ ਅਤੇ ਸੀਮਾਵਾਂ

ਮੁੱਲ ਸਟਰਿੰਗਾਂ, ਨੰਬਰ, ਬੂਲੀਅਨ ਜਾਂ null ਹੋ ਸਕਦੇ ਹਨ; ਬੂਲੀਅਨ true ਅਤੇ false ਵਜੋਂ ਰੈਂਡਰ ਹੁੰਦੇ ਹਨ। ਨਵੀਂ ਲਾਈਨ (\n), ਟੈਬ (\t), ਅਤੇ ਕੈਰਿਜ ਰਿਟਰਨ (\r) ਤੋਂ ਇਲਾਵਾ Unicode ਕੰਟਰੋਲ (Cc) ਅੱਖਰ, ਜ਼ੀਰੋ-ਵਿਡਥ ਨਾਨ-ਜੌਇਨਰ ਅਤੇ ਜੌਇਨਰ (U+200C, U+200D, ਜੋ ਭਾਰਤੀ ਅਤੇ ਅਰਬੀ-ਲਿਪੀ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਸ਼ਬਦ ਜੋੜਦੇ ਹਨ) ਤੋਂ ਇਲਾਵਾ ਫਾਰਮੈਟ (Cf) ਅੱਖਰ, ਅਤੇ ਸਰੋਗੇਟ (Cs) ਕੋਡ ਪੁਆਇੰਟ ਹਟਾ ਦਿੱਤੇ ਜਾਂਦੇ ਹਨ; \r\n ਨੂੰ \n ਵਿੱਚ ਸਧਾਰਨ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। ਰੈਂਡਰ ਹੋਣ ਵੇਲੇ ਹਰੇਕ ਮੁੱਲ ਦੀ ਸੀਮਾ 2,000 ਅੱਖਰ ਹੈ। ਦਿੱਤੀਆਂ ਸਟਰਿੰਗਾਂ ਨੂੰ ਸਟੋਰੇਜ ਤੋਂ ਪਹਿਲਾਂ ਵੀ ਸਾਫ਼ ਅਤੇ ਛੋਟਾ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। ਮੂਲ ਆਬਜੈਕਟ UTF-8 JSON ਦੇ 32 KB ਵਿੱਚ ਫਿੱਟ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ; ਵੱਡੇ ਆਬਜੈਕਟਾਂ ਨੂੰ ਕਾਲ/ਸੈਸ਼ਨ ਬੇਨਤੀਆਂ ਵਿੱਚ 400 ਮਿਲਦਾ ਹੈ, ਜਦਕਿ ਕੈਂਪੇਨ ਇੰਪੋਰਟ ਅਵੈਧ ਕਤਾਰਾਂ ਨੂੰ ਵੱਖਰੇ ਤੌਰ ਤੇ ਰਿਪੋਰਟ ਕਰਦੇ ਹਨ। ਐਰੇ ਅਤੇ ਨੇਸਟ ਕੀਤੇ ਆਬਜੈਕਟ ਮੁੱਲਾਂ ਵਜੋਂ ਸਵੀਕਾਰ ਨਹੀਂ ਕੀਤੇ ਜਾਂਦੇ। ਨਾ ਮਿਲਦੀਆਂ ਮੈਟਾਡੇਟਾ ਕੁੰਜੀਆਂ (ਉਦਾਹਰਨ ਲਈ, ਖਾਲੀ ਥਾਂ ਵਾਲਾ CSV ਹੈਡਰ) ਰੱਖੀਆਂ ਅਤੇ ਵਾਪਸ ਭੇਜੀਆਂ ਜਾਂਦੀਆਂ ਹਨ, ਪਰ ਪਲੇਸਹੋਲਡਰ ਰਾਹੀਂ ਹਵਾਲਾ ਨਹੀਂ ਦਿੱਤਾ ਜਾ ਸਕਦਾ।

ਪ੍ਰਸੰਗ

context ਵੱਧ ਤੋਂ ਵੱਧ 20,000 ਅੱਖਰਾਂ ਦੀ ਇੱਕ ਸਟਰਿੰਗ ਹੈ। ThunderPhone ਇਸਨੂੰ prompt ਤੋਂ ਬਾਅਦ, prompt ਦੇ ਵੇਰੀਏਬਲ ਭਰਨ ਤੋਂ ਬਾਅਦ, ਇੱਕ ਸੀਮਾਬੱਧ ਬਲਾਕ ਵਜੋਂ ਜੋੜਦਾ ਹੈ:

<your prompt, with its variables filled in>
 
Details for this call:
<call_context>
Ada rescheduled twice last month. She prefers mornings and asked us not to call her work number.
</call_context>

ਏਜੰਟ ਇਸਨੂੰ ਆਪਣੀਆਂ ਹਦਾਇਤਾਂ ਦੇ ਨਾਲ ਪੜ੍ਹਦਾ ਹੈ, ਇਸ ਲਈ ਇਸਨੂੰ ਉਸੇ ਤਰ੍ਹਾਂ ਲਿਖੋ ਜਿਵੇਂ ਤੁਸੀਂ ਕਾਲ ਤੋਂ ਪਹਿਲਾਂ ਕਿਸੇ ਸਹਿਕਰਮੀ ਨੂੰ ਜਾਣਕਾਰੀ ਦਿੰਦੇ ਹੋ। ਪ੍ਰਸੰਗ ਟੈਂਪਲੇਟ ਨਹੀਂ ਹੈ: ਇਸ ਦੇ ਅੰਦਰ {{name}} ਜਿਵੇਂ ਲਿਖਿਆ ਹੈ ਤਿਵੇਂ ਹੀ ਰਹਿੰਦਾ ਹੈ। ਜੇ ਟੈਕਸਟ ਨੂੰ ਕਿਸੇ ਮੁੱਲ ਦੀ ਲੋੜ ਹੈ, ਤਾਂ ਭੇਜਣ ਤੋਂ ਪਹਿਲਾਂ ਮੁੱਲ ਖੁਦ ਸ਼ਾਮਲ ਕਰੋ।

  • null, ਖਾਲੀ ਸਟਰਿੰਗ, ਜਾਂ ਸਿਰਫ਼ ਖਾਲੀ ਥਾਂ ਦਾ ਮਤਲਬ ਹੈ ਕਿ ਕੋਈ ਸੰਦਰਭ ਨਹੀਂ ਹੈ।
  • ਜਿਹੜਾ ਮੁੱਲ ਸਟਰਿੰਗ ਨਹੀਂ ਹੈ, ਜਾਂ 20,000 ਅੱਖਰਾਂ ਤੋਂ ਲੰਮਾ ਹੈ, ਉਸ ਨੂੰ ਕਾਲ ਅਤੇ ਸੈਸ਼ਨ ਬੇਨਤੀਆਂ ਵਿੱਚ 400 ਨਾਲ ਅਸਵੀਕਾਰ ਕੀਤਾ ਜਾਂਦਾ ਹੈ; ਸੰਰਚਨਾ webhook ਤੋਂ ਇਹ ਅਵਿਨਿਆਸ variables ਵਾਂਗ ਐਕਸਚੇਂਜ ਨੂੰ ਅਸਫਲ ਕਰਦਾ ਹੈ (ਹੇਠਾਂ ਵੇਖੋ)।
  • ਸ਼ੁਰੂ ਅਤੇ ਅੰਤ ਦੀ ਖਾਲੀ ਥਾਂ ਹਟਾਈ ਜਾਂਦੀ ਹੈ, ਅਤੇ ਵੇਰੀਏਬਲ ਮੁੱਲਾਂ ਵਾਂਗ ਹੀ ਕੰਟਰੋਲ ਅਤੇ ਫਾਰਮੈਟ ਅੱਖਰ ਹਟਾਏ ਜਾਂਦੇ ਹਨ।
  • ਸੰਦਰਭ ਕਾਲ ਦੇ prompt ਦਾ ਹਿੱਸਾ ਹੈ, ਇਸ ਲਈ ਇਹ ਕਾਲ ਦੇ prompt ਆਕਾਰ ਵਿੱਚ ਗਿਣਿਆ ਜਾਂਦਾ ਹੈ।

steps ਏਜੰਟ ਵਿੱਚ, ਪ੍ਰਸੰਗ ਕਾਲ ਦੇ ਹਰੇਕ ਏਜੰਟ ਦੇ prompt ਤੋਂ ਬਾਅਦ ਹੁੰਦਾ ਹੈ, ਹਰੇਕ ਸਟੈਪ ਦੀਆਂ ਹਦਾਇਤਾਂ ਤੋਂ ਬਾਅਦ ਨਹੀਂ।

ਮੁੱਲ ਕਿੱਥੋਂ ਆਉਂਦੇ ਹਨ

ਆਉਟਬਾਊਂਡ API

POST /v1/call ਉੱਤੇ variables ਅਤੇ context ਭੇਜੋ:

{
  "from_number": "+15551234567",
  "to_number": "+14155552671",
  "agent_id": 12,
  "variables": {
    "name": "Ada",
    "account_id": "A-17",
    "appointment_slot": "Tuesday at 10 AM"
  },
  "context": "Ada asked to be called back about the late fee on her March invoice."
}

ਦੋਵੇਂ ਫ਼ੋਨ ਨੰਬਰ ਦੇ ਡਿਫਾਲਟ ਆਉਟਬਾਊਂਡ ਏਜੰਟ ਜਾਂ ਇਨਲਾਈਨ config.prompt ਨਾਲ ਵੀ ਕੰਮ ਕਰਦੇ ਹਨ। ਇਨਲਾਈਨ config ਨਾਲ, context ਨੂੰ config ਦੇ ਅੰਦਰ ਵੀ ਰੱਖਿਆ ਜਾ ਸਕਦਾ ਹੈ, ਜੋ ਉਹੀ ਫ਼ੀਲਡ ਹੈ ਜੋ ਕਨਫਿਗਰੇਸ਼ਨ webhook ਵਾਪਸ ਕਰਦਾ ਹੈ; ਜੇ ਤੁਸੀਂ ਦੋਵੇਂ ਭੇਜਦੇ ਹੋ, ਤਾਂ ਉਹਨਾਂ ਦਾ ਟੈਕਸਟ ਇੱਕੋ ਜਿਹਾ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ। ਵੱਖਰੇ variables ਜਾਂ ਵੱਖਰੇ context ਨਾਲ idempotency key ਨੂੰ ਦੁਬਾਰਾ ਵਰਤਿਆ ਨਹੀਂ ਜਾ ਸਕਦਾ।

ਕੈਂਪੇਨ CSV

ਗੈਰ-ਫੋਨ CSV ਕਾਲਮ ਪਹਿਲਾਂ ਹੀ ਸੰਪਰਕ ਵੇਰੀਏਬਲਾਂ ਵਜੋਂ ਸਟੋਰ ਹਨ। ਹਰ ਡਾਇਲ ਹੁਣ ਉਨ੍ਹਾਂ ਨੂੰ ਆਪਣੇ ਆਪ ਵਰਤਦਾ ਹੈ। ਆਪਣੇ ਪਲੇਸਹੋਲਡਰਾਂ ਨਾਲ ਮੇਲ ਕਰਨ ਲਈ name, account_id, ਅਤੇ appointment_slot ਵਰਗੇ ਹੈਡਰ ਵਰਤੋ। ਮੌਜੂਦਾ ਨਾਮ ਮੈਪਿੰਗ ਪਹਿਲੇ ਅਤੇ ਆਖਰੀ ਨਾਮ ਦੇ ਕਾਲਮਾਂ ਨੂੰ name ਵੇਰੀਏਬਲ ਵਿੱਚ ਜੋੜ ਸਕਦੀ ਹੈ। ਕੈਂਪੇਨ ਸੰਪਰਕਾਂ ਕੋਲ ਪ੍ਰਤੀ-ਸੰਪਰਕ ਸੰਦਰਭ ਨਹੀਂ ਹੁੰਦਾ।

ਡਾਇਨਾਮਿਕ ਕੌਂਫਿਗਰੇਸ਼ਨ webhook

ਬਲਾਕਿੰਗ ਕਨਫਿਗਰੇਸ਼ਨ webhook ਪਾਥ 'ਤੇ, ਆਪਣੀ ਸੰਸਥਾ ਵਿੱਚੋਂ ਇੱਕ ਸੁਰੱਖਿਅਤ ਏਜੰਟ ਅਤੇ ਹਰ ਕਾਲ ਲਈ ਮੁੱਲ ਵਾਪਸ ਕਰੋ। ਫੁੱਲ ਡੁਪਲੈਕਸ ਏਜੰਟ ਲਈ, ਭਾਵੇਂ ਕਾਲ ਕਿਸੇ ਹੋਰ ਸਮਰਥਿਤ ਭਾਸ਼ਾ ਵਿੱਚ ਸ਼ੁਰੂ ਹੋਵੇ, ਕਾਲ ਏਜੰਟ ਦੀ ਆਵਾਜ਼ ਬਣਾਈ ਰੱਖਦੀ ਹੈ: ਹਰ-ਭਾਸ਼ਾ ਆਵਾਜ਼ ਮੈਪਿੰਗਾਂ ਅਤੇ ਮੂਲ ਆਵਾਜ਼ ਬਦਲਣਾ ਉਸ ਕਾਲ 'ਤੇ ਲਾਗੂ ਨਹੀਂ ਹੁੰਦੇ।

{
  "agent_id": 12,
  "variables": {"name": "Ada", "account_id": "A-17"},
  "context": "[REDACTED_LITERAL]"
}
{
  "agent_id": 12,
  "variables": {"name": "Ada", "account_id": "A-17"},
  "context": "Ada called yesterday about a leak in unit 4B; a plumber is booked for Friday."
}

ਜਵਾਬ ਦੇ ਵੇਰੀਏਬਲ ਬੇਨਤੀ-ਪੱਧਰ ਦੇ ਵੇਰੀਏਬਲਾਂ ਨੂੰ ਓਵਰਰਾਈਟ ਕਰਦੇ ਹਨ, ਜਦਕਿ ਬਾਕੀ ਬੇਨਤੀ ਕੀਜ਼ ਰਹਿੰਦੀਆਂ ਹਨ। null ਦਾ ਜਵਾਬੀ ਮੁੱਲ ਪਲੇਸਹੋਲਡਰ ਦਾ ਡਿਫੌਲਟ ਚੁਣਦਾ ਹੈ। ਮਿਲਾਇਆ ਗਿਆ ਆਬਜੈਕਟ ਵੀ 32 KB ਵਿੱਚ ਸਮਾਉਣਾ ਲਾਜ਼ਮੀ ਹੈ। ਸੇਵ ਕੀਤੇ ਏਜੰਟ ਦੇ ਜਵਾਬ ਸਿਰਫ਼ agent_id, variables, context, language ਅਤੇ ਪ੍ਰਤੀ-ਕਾਲ timezone ਸਵੀਕਾਰ ਕਰਦੇ ਹਨ; ਜਦੋਂ ਤੁਹਾਨੂੰ prompt ਜਾਂ ਹੋਰ ਸੈਟਿੰਗਾਂ ਬਦਲਣੀਆਂ ਹੋਣ, ਤਾਂ ਇਨਲਾਈਨ ਕੌਂਫਿਗਰੇਸ਼ਨ ਵਾਪਸ ਕਰੋ। ਸੇਵ ਕੀਤੇ ਏਜੰਟ ਦੇ webhook ਜਵਾਬ ਫੋਨ ਅਤੇ ਵਿਜਟ ਦੋਵੇਂ ਕਾਲਾਂ ਲਈ ਏਜੰਟ ਦੀ ਤਾਇਨਾਤ ਕੀਤੀ A/B ਵੰਡ ਵਰਤਦੇ ਹਨ; ਵੇਰੀਏਬਲ ਵੇਰੀਐਂਟ ਚੋਣ ਤੋਂ ਬਾਅਦ ਰੈਂਡਰ ਹੁੰਦੇ ਹਨ। ਜਦੋਂ ਜਵਾਬ ਕਿਸੇ ਗੈਰ-ਫੁੱਲ ਡੁਪਲੈਕਸ ਏਜੰਟ ਲਈ language ਸੈੱਟ ਕਰਦਾ ਹੈ, ਤਾਂ ਕਾਲ ਉਸ ਭਾਸ਼ਾ ਦੀ ਆਪਣੀ ਆਵਾਜ਼ ਵੀ ਵਰਤਦੀ ਹੈ ਜੇ ਏਜੰਟ ਲਈ ਉਹ ਸੈੱਟ ਕੀਤੀ ਹੋਵੇ। prompt ਵਾਲਾ ਜਵਾਬ ਹਮੇਸ਼ਾ ਇਨਲਾਈਨ ਕੌਂਫਿਗਰੇਸ਼ਨ ਵਰਤਦਾ ਹੈ: ਉਸ ਜਵਾਬ ਵਿੱਚ ਕੋਈ ਵੀ agent_id ਅਣਡਿੱਠਾ ਕੀਤਾ ਜਾਂਦਾ ਹੈ, ਜਿਸ ਵਿੱਚ ਨਲ ਜਾਂ ਗੈਰ-ਪੂਰਨ-ਅੰਕ ਮੈਟਾਡੇਟਾ ਵੀ ਸ਼ਾਮਲ ਹੈ। ਇਨਲਾਈਨ prompt ਨੂੰ ਫਿਰ ਵੀ ਆਮ ਪ੍ਰਮਾਣਿਕਤਾ ਜਾਂਚ ਪਾਸ ਕਰਨੀ ਲਾਜ਼ਮੀ ਹੈ। ਇਨਲਾਈਨ webhook ਜਵਾਬਾਂ ਵਿੱਚ variables ਅਤੇ context ਵੀ ਸ਼ਾਮਲ ਹੋ ਸਕਦੇ ਹਨ। ਜੇ context ਸਟਰਿੰਗ ਨਹੀਂ ਹੈ ਜਾਂ ਬਹੁਤ ਲੰਮਾ ਹੈ, ਤਾਂ ਐਕਸਚੇਂਜ ਅਸਫਲ ਹੋ ਜਾਂਦਾ ਹੈ: ਫੋਨ ਕਾਲ ਰੱਦ ਕਰ ਦਿੱਤੀ ਜਾਂਦੀ ਹੈ, ਅਤੇ ਵਿਜਟ ਸੈਸ਼ਨ ਬੇਨਤੀ 400 ਨਾਲ ਅਸਫਲ ਹੁੰਦੀ ਹੈ। ਸੇਵ ਕੀਤੇ ਏਜੰਟ ਦੇ webhook ਜਵਾਬ ਫੋਨ ਅਤੇ ਵਿਜਟ ਦੋਵੇਂ ਕਾਲਾਂ ਲਈ ਏਜੰਟ ਦੀ ਤਾਇਨਾਤ ਕੀਤੀ A/B ਵੰਡ ਵਰਤਦੇ ਹਨ; ਵੇਰੀਏਬਲ ਵੇਰੀਐਂਟ ਚੋਣ ਤੋਂ ਬਾਅਦ ਰੈਂਡਰ ਹੁੰਦੇ ਹਨ। ਇਨਬਾਊਂਡ ਫੋਨ ਕਾਲਾਂ ਲਈ, ਅਜਿਹਾ ਨੰਬਰ ਵਰਤੋ ਜਿਸ ਨੂੰ ਕੋਈ ਇਨਬਾਊਂਡ ਏਜੰਟ ਅਸਾਈਨ ਨਾ ਕੀਤਾ ਹੋਵੇ ਅਤੇ ਉਸ ਦਾ ਫੋਨ-ਨੰਬਰ ਜਾਂ ਸੰਗਠਨ webhook ਕੌਂਫਿਗਰ ਕਰੋ; ਵਿਜਟ ਕੀਜ਼ mode="webhook" ਵਰਤਦੀਆਂ ਹਨ। ਐਂਡਪੌਇੰਟ-ਸਿਸਟਮ ਦੀਆਂ ਆਉਣ ਵਾਲੀਆਂ ਨੋਟੀਫਿਕੇਸ਼ਨਾਂ ਬਲੌਕਿੰਗ ਕੌਂਫਿਗਰੇਸ਼ਨ ਜਵਾਬ ਪ੍ਰਦਾਨ ਨਹੀਂ ਕਰਦੀਆਂ।

ਏਜੰਟ ਕਾਲ ਸੈਟਅੱਪ webhook

ਕਿਸੇ ਨੰਬਰ ਨੂੰ ਇਸਦੇ ਏਜੰਟ ਨਾਲ ਜੋੜਿਆ ਰੱਖਣ ਅਤੇ ਸਿਰਫ਼ ਕਾਲ ਦੇ ਮੁੱਲ ਭਰਨ ਲਈ, ਏਜੰਟ ਨੂੰ ਇੱਕ ਕਾਲ ਸੈਟਅੱਪ webhook ਦਿਓ। ਏਜੰਟ ਦੇ ਕਿਸੇ ਨੰਬਰ 'ਤੇ ਹਰ ਇਨਬਾਊਂਡ ਕਾਲ ਦਾ ਜਵਾਬ ਦੇਣ ਤੋਂ ਪਹਿਲਾਂ, webhook ਨੂੰ ਕਾਲ ਅਤੇ ਏਜੰਟ ਦੀ ID, ਨਾਮ ਅਤੇ ਵਰਜਨ ਮਿਲਦਾ ਹੈ, ਅਤੇ ਇਹ agent_id ਦੀ ਲੋੜ ਤੋਂ ਬਿਨਾਂ ਉੱਪਰ ਦਿੱਤੇ ਉਹੀ variables, context, language ਅਤੇ ਪ੍ਰਤੀ-ਕਾਲ timezone ਨਾਲ ਜਵਾਬ ਦਿੰਦਾ ਹੈ। ਉਹ ਏਜੰਟ ਜਿਸ ਦੀਆਂ ਸੈਟਿੰਗਾਂ ਵਿੱਚ ਬਿਨਾਂ ਡਿਫੌਲਟ ਵਾਲਾ placeholder ਵਰਤਿਆ ਗਿਆ ਹੈ, ਉਸ ਨੂੰ ਫੋਨ ਨੰਬਰ 'ਤੇ ਕਾਲ ਦਾ ਜਵਾਬ ਦੇਣ ਲਈ ਇਸ webhook ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ: webhook ਅਸਫਲ ਹੋਣ 'ਤੇ ਕਾਲ ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦੀ। {{name|there}} ਵਰਗੇ ਡਿਫੌਲਟ ਵਾਲੇ placeholders ਏਜੰਟ ਨੂੰ ਇਸ ਤੋਂ ਬਿਨਾਂ ਜਵਾਬ ਦੇਣ ਦਿੰਦੇ ਹਨ।

SIP ਹੈਡਰ

ਜਿਹੜੀਆਂ ਕਾਲਾਂ SIP ਰਾਹੀਂ ਕਿਸੇ ਏਜੰਟ ਤੱਕ ਪਹੁੰਚਦੀਆਂ ਹਨ (ਇੱਕ SIP ਪਤਾ, ਜਾਂ ਮੈਨੁਅਲ SIP ਕਨੈਕਸ਼ਨ ਉੱਤੇ ਕੋਈ ਨੰਬਰ) ਉਹ X-* ਅਤੇ User-to-User ਹੈਡਰਾਂ ਵਿੱਚ ਸੰਦਰਭ ਲਿਆ ਸਕਦੀਆਂ ਹਨ। ਹਰ ਇੱਕ sip_ ਵੇਰੀਏਬਲ ਬਣ ਜਾਂਦਾ ਹੈ, ਜਿਵੇਂ ਕਿ {{sip_x_amzn_connectcontactid}} ਜਾਂ {{sip_uui}}, ਅਤੇ ਇਸਦੀ ਤਰਜੀਹ ਸਭ ਤੋਂ ਘੱਟ ਹੁੰਦੀ ਹੈ: API ਜਾਂ webhook ਤੋਂ ਉਸੇ ਨਾਮ ਦਾ ਮੁੱਲ ਤਰਜੀਹ ਲੈਂਦਾ ਹੈ। SIP ਹੈਡਰਾਂ ਵਿੱਚ ਕਾਲ ਸੰਦਰਭ ਭੇਜੋ ਵੇਖੋ। ਹੈਡਰ ਮੁੱਲ ਭੇਜਣ ਵਾਲੇ ਵੱਲੋਂ ਸੈੱਟ ਕੀਤੇ ਜਾਂਦੇ ਹਨ, ਇਸ ਲਈ ਉਹਨਾਂ ਨੂੰ ਕਿਸੇ ਵੀ ਬ੍ਰਾਊਜ਼ਰ-ਦੁਆਰਾ ਦਿੱਤੇ ਮੁੱਲ ਵਾਂਗ ਗੈਰ-ਭਰੋਸੇਯੋਗ ਸਮਝੋ।

ਵਿਜਟ ਸੈਸ਼ਨ API

POST /v1/widget/session ਉੱਪਰੀ-ਪੱਧਰ ਦੇ variables ਅਤੇ language ਨੂੰ ਸਵੀਕਾਰ ਕਰਦਾ ਹੈ। ਇਸਦੀ ਪ੍ਰਕਾਸ਼ਯੋਗ ਕੁੰਜੀ ਸੁਰੱਖਿਅਤ ਏਜੰਟ ਨੂੰ ਚੁਣਦੀ ਹੈ। Webhook-ਮੋਡ ਕੁੰਜੀਆਂ ਇਹ ਮੁੱਲ ਕੌਂਫਿਗਰੇਸ਼ਨ webhook ਨੂੰ ਅੱਗੇ ਭੇਜਦੀਆਂ ਹਨ ਅਤੇ ਜਵਾਬ ਨੂੰ ਉੱਪਰ ਦੱਸੇ ਅਨੁਸਾਰ ਮਿਲਾਉਂਦੀਆਂ ਹਨ। ਬ੍ਰਾਊਜ਼ਰ ਵੱਲੋਂ ਦਿੱਤੇ widget variables ਕਲਾਇੰਟ-ਨਿਯੰਤਰਿਤ ਹੁੰਦੇ ਹਨ, ਅਤੇ ਉੱਪਰ ਦੱਸੇ ਤਸਦੀਕ ਅਤੇ ਸਟਰਿੰਗ ਸਫ਼ਾਈ ਤੋਂ ਬਾਅਦ web.incoming ਵਿੱਚ ਬਿਨਾਂ ਬਦਲਾਅ ਅੱਗੇ ਭੇਜੇ ਜਾਂਦੇ ਹਨ, ਅਤੇ completion webhooks ਅਤੇ ਕਾਲ ਇਤਿਹਾਸ ਵਿੱਚ ਦੁਹਰਾਏ ਜਾਂਦੇ ਹਨ। ਇਨ੍ਹਾਂ ਨੂੰ ਭਰੋਸੇਯੋਗ ਪਛਾਣ ਜਾਂ ਅਧਿਕਾਰਤਾ ਡਾਟਾ ਨਾ ਸਮਝੋ।

ਵਿਜਟ ਦਾ ਆਪਣਾ ਬ੍ਰਾਊਜ਼ਰ context ਫੀਲਡ ਵੱਖਰਾ ਹੈ: ਇਹ ਉਸ ਪੰਨੇ ਤੋਂ ਟੈਕਸਟ ਲਿਆਉਂਦਾ ਹੈ ਜਿੱਥੇ ਵਿਜ਼ਟਰ ਮੌਜੂਦ ਹੁੰਦਾ ਹੈ, ਜਿਸਨੂੰ ਏਜੰਟ ਵੈੱਬਸਾਈਟ ਸਮੱਗਰੀ ਵਜੋਂ ਸਮਝਦਾ ਹੈ (ਦੇਖੋ ਵੈੱਬ ਵਿਜਟ ਏਮਬੈਡ ਕਰੋ)। ਵਿਜਟ ਕਾਲ ਦਾ ਹਰ-ਕਾਲ ਪ੍ਰਸੰਗ ਉੱਪਰ ਦੱਸੇ ਅਨੁਸਾਰ ਵੈੱਬਹੁੱਕ-ਮੋਡ ਕੁੰਜੀ ਦੇ ਕਨਫਿਗਰੇਸ਼ਨ ਵੈੱਬਹੁੱਕ ਤੋਂ ਆਉਂਦਾ ਹੈ। ਜਦੋਂ ਕਿਸੇ ਕਾਲ ਵਿੱਚ ਦੋਵੇਂ ਹੁੰਦੇ ਹਨ, ਤਾਂ ਹਰ-ਕਾਲ ਪ੍ਰਸੰਗ ਪਹਿਲਾਂ ਆਉਂਦਾ ਹੈ, ਫਿਰ ਪੰਨੇ ਦੀ ਸਮੱਗਰੀ।

ਰੀਅਲਟਾਈਮ ਸੈਸ਼ਨ API

POST /v1/realtime/sessions agent_id ਜਾਂ ਇਨਲਾਈਨ config ਦੇ ਨਾਲ ਟੌਪ-ਲੈਵਲ variables, context ਅਤੇ language ਸਵੀਕਾਰ ਕਰਦਾ ਹੈ:

{
  "agent_id": 12,
  "variables": {"name": "Ada"},
  "context": "Ada is calling from the front desk about a guest's lost key card."
}

context ਸਿਰਫ਼ ਉੱਪਰੀ ਪੱਧਰ ਤੇ ਜਾਂਦਾ ਹੈ; ਇਨਲਾਈਨ config ਇਸਨੂੰ ਇੱਕ ਅਣਜਾਣ ਫੀਲਡ ਵਜੋਂ ਰੱਦ ਕਰਦਾ ਹੈ।

ਰੀਅਲਟਾਈਮ WebSocket

ਸੇਵ ਕੀਤੇ ਏਜੰਟ ਨਾਲ, ਸੇਵ ਕੀਤੇ ਏਜੰਟ ਦਾ ਡਿਪਲੌਇ ਕੀਤਾ prompt ਉਸਦਾ prompt ਹੀ ਰਹਿੰਦਾ ਹੈ। session.instructions ਕਾਲ ਦਾ ਸੰਦਰਭ ਬਣ ਜਾਂਦਾ ਹੈ, session.prompt.variables (ਜਾਂ session.config.variables) ਉਸਦੇ ਵੇਰੀਏਬਲ ਬਣ ਜਾਂਦੇ ਹਨ, ਅਤੇ session.language ਉਸਦੀ ਪ੍ਰਤੀ-ਕਾਲ ਭਾਸ਼ਾ ਬਣ ਜਾਂਦੀ ਹੈ। ਪਹਿਲੇ session.update ਵਿੱਚ session.prompt.id ਨਾਲ ਏਜੰਟ ਚੁਣੋ, ਜੋ ਉਹ ਅੱਪਡੇਟ ਮਿਲਣ ਉੱਤੇ ਸੈਸ਼ਨ ਸ਼ੁਰੂ ਕਰਦਾ ਹੈ:

{
  "type": "session.update",
  "session": {
    "type": "realtime",
    "prompt": {"id": "12", "variables": {"name": "Ada"}},
    "instructions": "Ada asked for a callback about her delivery window."
  }
}

ਕਨੈਕਸ਼ਨ URL ਉੱਤੇ ?agent_id=12 ਸਾਕਟ ਕਨੈਕਟ ਹੁੰਦੇ ਹੀ, ਕਿਸੇ ਵੀ session.update ਤੋਂ ਪਹਿਲਾਂ, ਏਜੰਟ ਸ਼ੁਰੂ ਕਰਦਾ ਹੈ, ਇਸ ਲਈ ਇਸ ਵਿੱਚ ਪ੍ਰਤੀ-ਕਾਲ ਇਨਪੁੱਟ ਨਹੀਂ ਹੁੰਦੀ। ਪਹਿਲੇ session.update ਦੀ ਉਡੀਕ ਕਰਨ ਅਤੇ ਇਸ ਦੀਆਂ ਹਦਾਇਤਾਂ ਤੇ ਵੇਰੀਏਬਲ ਵਰਤਣ ਲਈ &wait_for_session_update=1 ਸ਼ਾਮਲ ਕਰੋ।

ਇਨਲਾਈਨ ਸੈਸ਼ਨ ਵਿੱਚ (ਕੋਈ ਸੇਵ ਕੀਤਾ ਏਜੰਟ ਨਹੀਂ), session.instructions ਪਹਿਲਾਂ ਵਾਂਗ ਖੁਦ prompt ਹੁੰਦਾ ਹੈ। ਬਿਲਡਰ ਮਾਈਕ ਅਤੇ ਸਿਮੂਲੇਟ ਕੀਤੀਆਂ ਟੈਸਟ ਕਾਲਾਂ ਡਿਫਾਲਟ ਅਤੇ ਗੁੰਮ ਪਲੇਸਹੋਲਡਰ ਹੱਲ ਕਰਦੀਆਂ ਹਨ, ਪਰ ਇਨ੍ਹਾਂ ਵਿੱਚ ਪ੍ਰਤੀ-ਕਾਲ ਵੇਰੀਏਬਲ ਜਾਂ ਸੰਦਰਭ ਇਨਪੁੱਟ ਨਹੀਂ ਹੁੰਦੀ।

ਕਾਲ ਤੋਂ ਬਾਅਦ

GET /v1/calls, GET /v1/calls/{call_id}, telephony.complete, ਅਤੇ web.complete ਵਿੱਚ ਅੰਤਿਮ ਮਿਲੇ ਹੋਏ variables ਅਤੇ unresolved_variables ਸ਼ਾਮਲ ਹੁੰਦੇ ਹਨ। ਪੁਰਾਣੇ completion payloads ਜਿਨ੍ਹਾਂ ਵਿੱਚ data.history ਸ਼ਾਮਲ ਹੁੰਦਾ ਹੈ, ਉਹਨਾਂ ਵਿੱਚ ਵੀ ਇਹ ਸ਼ਾਮਲ ਹੁੰਦੇ ਹਨ:

{
  "variables": {"name": "Ada", "account_id": "A-17"},
  "unresolved_variables": ["appointment_slot"]
}

ਕਾਲ ਦਾ prompt_snapshot (GET /v1/calls/{call_id}) ਏਜੰਟ ਦਾ prompt ਦਿਖਾਉਂਦਾ ਹੈ, ਜਿਸ ਵਿੱਚ ਇਸਦੇ ਵੇਰੀਏਬਲ ਭਰੇ ਹੋਏ ਅਤੇ ਸੰਦਰਭ ਬਲਾਕ ਸ਼ਾਮਲ ਹੁੰਦਾ ਹੈ।

ਪੂਰੀ ਹੋਈ ਕਾਲ ਨੂੰ ਇਸਦੇ ਸਰੋਤ ਰਿਕਾਰਡ ਨਾਲ ਜੋੜਨ ਲਈ ਆਪਣੇ CRM ਜਾਂ ਟਾਸਕ ਪਛਾਣਕਰਤਾ ਨੂੰ ਵੇਰੀਏਬਲ ਆਬਜੈਕਟ ਵਿੱਚ ਸਟੋਰ ਕਰੋ। ਵੇਰੀਏਬਲ ਅਤੇ ਸੰਦਰਭ ਕਾਲ ਰਿਕਾਰਡ ਨਾਲ ਸੰਭਾਲੇ ਜਾਂਦੇ ਹਨ; ਸਿਰਫ਼ ਉਹੀ ਜਾਣਕਾਰੀ ਭੇਜੋ ਜੋ ਕਾਲ ਇਤਿਹਾਸ ਅਤੇ ਵੈੱਬਹੁੱਕਾਂ ਵਿੱਚ ਸੰਭਾਲਣ ਲਈ ਉਚਿਤ ਹੋਵੇ।

ਕਾਲ ਦੇ ਰੀਪਲੇ, ਵੈਲੀਡੇਸ਼ਨ ਸੈੱਟਾਂ, ਰੀਪਲੇ ਰਨਾਂ ਅਤੇ ਜਾਂਚਾਂ ਵਿੱਚ, ਟੈਸਟ ਅਧੀਨ prompt ਨਾਲ ਉਸ ਕਾਲ ਦੇ ਵੇਰੀਏਬਲ ਅਤੇ ਸੰਦਰਭ ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹਨ, ਇਸ ਲਈ ਰੀਪਲੇ ਇਹ ਜਾਂਚਦਾ ਹੈ ਕਿ ਉਸ ਕਾਲ ਦੇ ਏਜੰਟ ਨੂੰ ਕੀ ਦੱਸਿਆ ਗਿਆ ਹੋਵੇਗਾ।

ਮੌਜੂਦਾ prompt ਅਨੁਕੂਲਤਾ

ਰੈਂਡਰਿੰਗ ਮੌਜੂਦਾ ਸੇਵ ਕੀਤੇ ਏਜੰਟ ਅਤੇ A/B ਵੈਰੀਐਂਟ promptਾਂ, ਇਨਲਾਈਨ ਆਊਟਬਾਊਂਡ ਅਤੇ ਰੀਅਲਟਾਈਮ ਕਨਫਿਗਰੇਸ਼ਨਾਂ, ਅਤੇ ਕਨਫਿਗਰੇਸ਼ਨ ਵੈੱਬਹੁੱਕਾਂ ਵੱਲੋਂ ਵਾਪਸ ਕੀਤੇ ਗਏ promptਾਂ 'ਤੇ ਵੀ ਲਾਗੂ ਹੁੰਦੀ ਹੈ। ਅਣਜਾਣ {{name}} ਪਲੇਸਹੋਲਡਰ ਖਾਲੀ ਟੈਕਸਟ ਬਣ ਜਾਂਦੇ ਹਨ, ਭਾਵੇਂ ਕੋਈ variables ਨਾ ਦਿੱਤੇ ਗਏ ਹੋਣ। ਰੋਲਆਊਟ ਤੋਂ ਪਹਿਲਾਂ ਮੌਜੂਦਾ promptਾਂ ਦੀ ਜਾਂਚ ਕਰੋ, ਜਿਸ ਵਿੱਚ ਬਾਹਰੋਂ ਦਿੱਤੇ ਇਨਲਾਈਨ/ਵੈੱਬਹੁੱਕ prompt ਵੀ ਸ਼ਾਮਲ ਹਨ ਜਿਨ੍ਹਾਂ ਦੀ ThunderPhone ਸੂਚੀ ਤਿਆਰ ਨਹੀਂ ਕਰ ਸਕਦਾ। Builder ਮਾਈਕ ਅਤੇ ਸਿਮੂਲੇਸ਼ਨ ਕਾਲਾਂ ਉਹੀ ਡਿਫਾਲਟ/ਖਾਲੀ ਵਿਵਹਾਰ ਲਾਗੂ ਕਰਦੀਆਂ ਹਨ।