ThunderPhone 2.0 அறிமுகமாகிவிட்டது.நீங்களே தொடங்கலாம்; நிமிடத்திற்கு 2¢ முதல்.அறிவிப்பைப் படிக்கவும்

Webhooks

telephony.incoming / web.incoming

உள்வரும் அழைப்பின் கட்டமைப்பை நிகழ்நேரத்தில் வடிவமைக்கும் தடைசெய்யும் webhook.

ஒதுக்கப்பட்ட ஏஜென்ட் இல்லாத எண்ணை உள்வரும் தொலைபேசி அழைப்பு அடையும்போது, அல்லது mode="webhook" இல் உள்ள வெளியிடக்கூடிய விசையில் வலை விட்ஜெட் அமர்வு தொடங்கும்போது, ThunderPhone உங்கள் மரபு வெப்ஹுக் URL-க்கு தடுக்கும் telephony.incoming / web.incoming கோரிக்கையை அனுப்பி, உள்ளமைவு பதிலுக்காக அதிகபட்சம் 10 வினாடிகள் காத்திருக்கும். ஒவ்வொரு அழைப்பிற்கும் prompt, குரல் மற்றும் கருவிகளை மாறும் வகையில் தேர்ந்தெடுக்க இந்தப் பரிமாற்றத்தைப் பயன்படுத்துங்கள் — முழுமையான செயல்முறைக்கு மாறும் அழைப்பு உள்ளமைவு வழிகாட்டி-ஐப் பார்க்கவும்.

இந்தத் தடுக்கும் பரிமாற்றத்திற்கு மாற்று வழி இல்லை: உங்கள் கையாளி 2xx அல்லாத நிலையைத் திருப்பினால், நேரம் முடிந்தால் அல்லது சரிபார்ப்பில் தோல்வியடையும் உள்ளமைவைத் திருப்பினால், அழைப்பு நிராகரிக்கப்படும் (தொலைபேசி அழைப்பு இணைக்கப்படாது; விட்ஜெட் அமர்வு கோரிக்கை 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 எண்களில் ஒன்று)

வலை விட்ஜெட் அமர்வுகளுக்கு (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சரம்விட்ஜெட் ஒவ்வொரு அமர்விற்குமான பக்கச் சூழலை அனுப்பியபோது இருக்கும்

பதில் ஸ்கீமா

இந்த அழைப்பிற்கான ஏஜென்ட் கட்டமைப்பை விவரிக்கும் JSON ஆப்ஜெக்ட்டைத் திருப்பி அனுப்பவும். prompt மற்றும் voice அவசியம்; மற்ற அனைத்தும் விருப்பமானவை.

{
  "prompt":  "You are a helpful booking assistant for Acme Restaurant.",
  "voice":   "john",
  "product": "spark",
  "background_track": null,
  "tools":   []
}
புலம்வகைஅவசியம்விளக்கம்
promptstringஆம்ஏஜென்ட்டை இயக்கும் சிஸ்டம் prompt
voicestringஆம்GET /v1/voices இலிருந்து குரல் id, எடுத்துக்காட்டாக john. voice_name ஒரு மாற்றுப் பெயராக ஏற்கப்படும். அறியப்படாத குரல்கள் சரிபார்ப்பில் தோல்வியடைந்து அழைப்பை நிராகரிக்கும்
productstringஇல்லைஇயல்புநிலை spark. அனுமதிக்கப்பட்டவை: spark, bolt, storm-base, storm-base-with-ack, storm-extra, storm-extra-with-ack
thinking_levelstringஇல்லைminimal, base (இயல்புநிலை), அல்லது extra. Storm தயாரிப்புகளுக்கு மேலெழுதப்படும்: storm-extra* என்பது extra-ஐ கட்டாயப்படுத்தும்; பிற storm-* என்பது base-ஐ கட்டாயப்படுத்தும்
audio_context_modestringஇல்லைfull (இயல்புநிலை) அல்லது reduced
watchdog_enabledbooleanஇல்லைஇந்த அழைப்பிற்கான மேற்பார்வையை இயக்கவும். இயல்புநிலை false
additional_audio_contextboolean | nullஇல்லைசமீபத்திய முறையை மட்டும் சேர்ப்பதற்குப் பதிலாக அழைப்பாளரின் ஆடியோவிலுள்ள கடைசி சில முறைகளைச் சேர்க்கவும்; இது சிறிய தாமதம்/செலவு கூடுதலுடன் திருத்தங்களையும் எழுத்துப்பிழை/எண்-அதிகமான தரவுச் சேகரிப்பையும் மேம்படுத்தும். உள்வரும் அமர்வுகளுக்கு இயல்பாக இயக்கப்பட்டும் வெளிச்செல்லும் தொலைபேசி அழைப்புகளுக்கு முடக்கப்பட்டும் இருக்கும்; null இயல்புநிலையைத் தக்கவைக்கும்
storm_feedback_modestringஇல்லைnone, acknowledgement (இயல்புநிலை), அல்லது tick
languagestringஇல்லைprimary_language என்பதற்கான சுருக்கம்
primary_languagestringஇல்லைமொழிக் குறியீடு, சீரமைக்கப்பட்டது (இயல்புநிலை en). தீர்மானிக்க முடியாத குறியீடுகள் அழைப்பை நிராகரிக்கும்
has_additional_languagesbooleanஇல்லைஇயல்புநிலை false
additional_languagesarray of stringஇல்லைஏஜென்ட் மாறக்கூடிய கூடுதல் மொழிகள்
native_voice_switchingbooleanஇல்லைஇயல்புநிலை false. அழைப்பு மற்றொரு மொழிக்கு மாறும்போது, கட்டமைக்கப்பட்ட குரலைத் தக்கவைப்பதற்குப் பதிலாக அந்த மொழியின் தாய்மொழிக் குரலுக்கு (பாலினத்துடன் பொருந்துமாறு) மாற்றவும்
background_trackstring | nullஇல்லைசூழல் ஆடியோ id அல்லது null
acknowledgement_prompt_modestringஇல்லைauto (இயல்புநிலை) அல்லது manual (Storm-with-ack தயாரிப்புகள்)
acknowledgement_promptstringஇல்லைacknowledgement_prompt_mode="manual" ஆக இருக்கும்போது பயன்படுத்தப்படும்
silence_interval_secondsinteger | nullஇல்லை5–120. சரிபார்ப்புக்கு முன் அழைப்பாளரின் அமைதிக்கான விநாடிகள்
silence_max_checkinsinteger | nullஇல்லை1–10
silence_checkins_enabledbooleanஇல்லைஇயல்புநிலை true
connect_tone_enabledbooleanஇல்லைஇயல்புநிலை false
voicemail_actionstringஇல்லைprompt (இயல்புநிலை), hangup, அல்லது message
voicemail_messagestringஇல்லைvoicemail_action="message" ஆக இருக்கும்போது பயன்படுத்தப்படும்
agent_namestringஇல்லைடாஷ்போர்டுகளுக்கும் விட்ஜெட்டிற்கும் தெரிவிக்கப்படும் காட்சிப் பெயர்
org_namestringஇல்லைஏஜென்ட்டின் ஆளுமைக்கான நிறுவனக் காட்சிப் பெயர்
toolsarrayஇல்லைஇன்லைன் செயல்பாட்டுக் கருவி ஸ்கீமாக்கள் (Function Tools ஐப் பார்க்கவும்)
call_idintegerஇல்லைகோரிக்கையின் அழைப்பு id-யின் விருப்ப எக்கோ; புறக்கணிக்கப்படும்

prompt மற்றும் voice அவசியம் என்பதால், {} அல்லது சரிபார்ப்பில் தோல்வியடையும் எந்தப் பதிலையும் திருப்பி அனுப்பினால் அழைப்பு 422 உடன் நிராகரிக்கப்படும் — இந்தப் பாதையில் நிலையான ஏஜென்ட் மீள்பயன்பாடு இல்லை (வெப்ஹுக் முறையில் ஒரு எண்ணுக்கோ விசைக்கோ ஒதுக்கப்பட்ட ஏஜென்ட் இல்லை).


பதில் அளவு வரம்பு


உதாரண ஹேண்ட்லர்

Python (FastAPI)
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 {}
Node.js (Express)
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({});
  },
);

function tools உடனான பதில்

உரையாடலின் நடுவில் AI உங்கள் API-களை அழைக்கக்கூடிய வகையில் tools-ஐ இணைக்கவும்:

{
  "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"
        }
      }
    }
  ]
}

தயாரிப்பு அடுக்கு விரைவுக் குறிப்பு

தயாரிப்புதாமதநேரம்பகுத்தறிதல்உறுதிப்படுத்தல்
sparkமிகக் குறைந்தஅடிப்படை
boltகுறைந்தமேம்பட்ட
storm-baseநடுத்தரவலுவான
storm-base-with-ackநடுத்தரவலுவானசிந்திக்கும் போது தானியங்கி இடைநிரப்பு
storm-extraஅதிகஆழமான
storm-extra-with-ackஅதிகஆழமானசிந்திக்கும் போது தானியங்கி இடைநிரப்பு

தொடர்புடையவை