ਵੈੱਬ ਵਿਜੇਟ ਏਮਬੈਡ ਕਰੋ

ਵੈੱਬ ਵਿਜਿਟ ਤੁਹਾਡੀ ਸਾਈਟ ਦੇ ਵਿਜ਼ਿਟਰਾਂ ਨੂੰ ਬ੍ਰਾਊਜ਼ਰ ਦੇ ਮਾਈਕ੍ਰੋਫ਼ੋਨ ਦੀ ਵਰਤੋਂ ਕਰਕੇ AI ਏਜੰਟ ਨਾਲ ਕਲਿੱਕ-ਟੂ-ਟਾਕ ਗੱਲਬਾਤ ਦਿੰਦਾ ਹੈ। ਇਹ ਆਪਣੇ SDK ਹਵਾਲੇ ਵਾਲਾ ਵੱਖਰਾ JavaScript / React SDK ਹੈ — ਇਹ ਗਾਈਡ ਵਿਜਿਟ ਲਈ ਲੋੜੀਂਦੇ ThunderPhone-ਪਾਸੇ ਦੇ ਸੈੱਟਅੱਪ ਉੱਤੇ ਕੇਂਦਰਿਤ ਹੈ।

ਲੋੜੀਂਦੀਆਂ ਸ਼ਰਤਾਂ

1. ਇੱਕ ਏਜੰਟ ਬਣਾਓ

   ਉਹ ਏਜੰਟ ਜਿਸਦਾ prompt ਅਤੇ ਆਵਾਜ਼ ਵਿਜਿਟ ਸੈਸ਼ਨ ਚਲਾਏਗਾ। widget_enabled: true ਸੈੱਟ ਕਰੋ (ਡਿਫਾਲਟ)।

2. ਰੂਟਿੰਗ ਮੋਡ ਚੁਣੋ
   • mode="agent" — ਹਰ ਕੀ ਲਈ ਇੱਕ ਸਥਿਰ ਏਜੰਟ। ਸਭ ਤੋਂ ਸੌਖਾ।
   • mode="webhook" — ਤੁਹਾਡਾ ਸਰਵਰ ਹਰ ਵਿਜ਼ਿਟਰ ਲਈ ਏਜੰਟ ਚੁਣਦਾ ਹੈ web.incoming webhook ਰਾਹੀਂ। ਇਸਨੂੰ ਲੌਗ-ਇਨ ਕੀਤੇ ਉਪਭੋਗਤਾਵਾਂ, A/B ਟੈਸਟਾਂ, ਜਾਂ ਪ੍ਰਤੀ-ਪੰਨਾ ਰੂਟਿੰਗ ਲਈ ਵਰਤੋ।
3. ਮਨਜ਼ੂਰਸ਼ੁਦਾ ਡੋਮੇਨਾਂ ਦੀ ਸੂਚੀ ਬਣਾਓ

   ਪਬਲਿਸ਼ੇਬਲ ਕੀਜ਼ ਓਰਿਜਿਨ-ਲੌਕਡ ਹੁੰਦੀਆਂ ਹਨ। ਤੁਹਾਨੂੰ ਹਰ ਉਸ ਹੋਸਟਨਾਮ ਦਾ ਨਾਮ ਦੇਣਾ ਹੋਵੇਗਾ ਜੋ ਵਿਜਿਟ embed ਕਰੇਗਾ। ਲੋਕਲ ਡਿਵੈਲਪਮੈਂਟ ਦੌਰਾਨ localhost / 127.0.0.1 ਹਮੇਸ਼ਾਂ ਮਨਜ਼ੂਰ ਹੁੰਦੇ ਹਨ।

ਇੱਕ ਪਬਲਿਸ਼ੇਬਲ ਕੀ ਬਣਾਓ

curl -X POST https://api.thunderphone.com/v1/publishable-key \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":            "Marketing site (prod)",
    "mode":            "agent",
    "agent_id":        12,
    "allowed_domains": ["example.com", "*.example.com"]
  }'

curl -X POST https://api.thunderphone.com/v1/publishable-key \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":            "Support (dynamic)",
    "mode":            "webhook",
    "webhook_url":     "https://example.com/thunderphone/widget-hook",
    "allowed_domains": ["support.example.com"]
  }'

ਜਵਾਬ ਵਿੱਚ pk_live_... ਨਾਲ ਸ਼ੁਰੂ ਹੋਣ ਵਾਲੀ ਇੱਕ key ਸ਼ਾਮਲ ਹੁੰਦੀ ਹੈ। ਪਬਲਿਸ਼ੇਬਲ ਕੀਜ਼ ਡਿਜ਼ਾਇਨ ਅਨੁਸਾਰ ਜਨਤਕ ਹਨ — ਤੁਹਾਡੇ ਫਰੰਟ-ਐਂਡ ਬੰਡਲ ਵਿੱਚ ਸ਼ਾਮਲ ਕਰਨ ਲਈ ਸੁਰੱਖਿਅਤ। ਸਾਰੀਆਂ ਫੀਲਡਾਂ ਲਈ ਪਬਲਿਸ਼ੇਬਲ ਕੀਜ਼ ਹਵਾਲਾ ਵੇਖੋ।

ਆਪਣੀ ਸਾਈਟ ਉੱਤੇ ਵਿਜਿਟ ਸ਼ਾਮਲ ਕਰੋ

ਤਿੰਨ ਇੰਟੀਗ੍ਰੇਸ਼ਨ ਵਿਕਲਪਾਂ ਬਾਰੇ ਵਿਜਿਟ SDK ਦਸਤਾਵੇਜ਼ਾਂ ਵਿੱਚ ਜਾਣਕਾਰੀ ਦਿੱਤੀ ਗਈ ਹੈ:

ਤਿੰਨੇ ਇੱਕੋ publishableKey ਸਵੀਕਾਰ ਕਰਦੇ ਹਨ ਅਤੇ ਮਾਈਕ ਬਟਨ ਨਾਲ ਕਾਲ-ਦੌਰਾਨ ਆਡੀਓ ਐਲੀਮੈਂਟ ਰੈਂਡਰ ਕਰਦੇ ਹਨ।

ਵਿਜਿਟ ਦਾ context 12,000 ਅੱਖਰਾਂ ਤੱਕ ਸੀਮਿਤ ਹੁੰਦਾ ਹੈ (ਆਮ ਅੰਗਰੇਜ਼ੀ ਟੈਕਸਟ ਦੇ ਲਗਭਗ 3,400 ਟੋਕਨ) ਅਤੇ ਇਹ prompt-ਆਕਾਰ ਸਰਚਾਰਜ ਵਿੱਚ ਗਿਣਿਆ ਜਾਂਦਾ ਹੈ।

ਵਿਜਿਟ-ਮੋਡ webhooks

ਜਦੋਂ mode="webhook" ਹੁੰਦਾ ਹੈ, ThunderPhone ਹਰ ਸੈਸ਼ਨ ਸ਼ੁਰੂ ਹੋਣ ਉੱਤੇ web.incoming ਪੇਲੋਡ ਨਾਲ ਤੁਹਾਡੇ webhook_url ਨੂੰ ਕਾਲ ਕਰਦਾ ਹੈ। ਉਸ ਵਿਜ਼ਿਟਰ ਲਈ ਚਲਾਉਣੀ ਏਜੰਟ ਸੰਰਚਨਾ ਵਾਪਸ ਕਰੋ — ਇਹ ਫ਼ੋਨ ਕਾਲਾਂ ਵਾਲੀ ਹੀ ਜਵਾਬ ਸਕੀਮਾ ਦੀ ਪਾਲਣਾ ਕਰਦੀ ਹੈ:

{
  "prompt":  "You are a VIP concierge for Jane Doe.",
  "voice":   "john",
  "product": "storm-base",
  "tools":   [ /* per-customer tools */ ]
}

ਤੁਸੀਂ ਆਪਣੇ ਸੈਸ਼ਨ ਦਾ ਸੰਦਰਭ (ਕਿਹੜਾ ਗਾਹਕ ਬ੍ਰਾਊਜ਼ ਕਰ ਰਿਹਾ ਹੈ, ਉਹ ਕਿਸ ਪੰਨੇ ਉੱਤੇ ਹਨ) prompt ਵਿੱਚ ਸ਼ਾਮਲ ਕਰ ਸਕਦੇ ਹੋ, ਅਤੇ ਰੋਲਆਉਟ ਅਨੁਸਾਰ ਏਜੰਟ ਬਦਲ ਸਕਦੇ ਹੋ।

ਸੈਸ਼ਨਾਂ ਦੀ ਨਿਗਰਾਨੀ ਕਰੋ

ਵਿਜਟ ਸੈਸ਼ਨ GET /v1/calls ਵਿੱਚ direction="widget" ਨਾਲ ਦਿਖਾਈ ਦਿੰਦੇ ਹਨ — ਫ਼ੋਨ ਕਾਲਾਂ ਵਾਂਗ ਹੀ ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ, ਰਿਕਾਰਡਿੰਗ, ਗ੍ਰੇਡਿੰਗ ਅਤੇ ਬਿਲਿੰਗ। ਸਿਰਫ਼ ਵਿਜਟ ਵਾਲਾ ਡੈਸ਼ਬੋਰਡ ਬਣਾਉਣ ਲਈ direction ਨਾਲ ਫਿਲਟਰ ਕਰੋ।

ਅਗਲੇ ਕਦਮ