Voximplant

Skapa eller välj en agent

Skapa agenten i ElevenAgents. Ge den ett första meddelande om den ska tala så snart samtalet kopplas upp. Ljudformat ställs in av integrationen, så agentens konfigurerade format används inte för Voximplant-samtal.

Aktivera Avsluta samtal

Under Agent → Tools → System tools aktiverar du End call så att agenten kan avsluta samtalet. Skälet som agenten anger när den avslutar samtalet skickas till ditt scenario med beslutet.

Lägg till en Voximplant-överföringsregel (valfritt)

För att låta agenten koppla uppringaren till en människa ger du den systemverktyget Transfer to number med en överföringsregel vars leverantörskonfiguration är voximplant. Regeln har ingen destination: samtalet avslutas med beslutet transfer-to-agent och ditt scenario dirigerar uppringaren. Överföringsregler konfigureras via API:t. Lägg till verktyget med en PATCH på agenten:

curl -X PATCH "https://api.elevenlabs.io/v1/convai/agents/agent_7101k5zvyjhmfg983brhmhkd98n6" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "conversation_config": {"agent": {"prompt": {"built_in_tools": {
      "end_call": {"type": "system", "name": "end_call", "description": "",
                   "params": {"system_tool_type": "end_call"}},
      "transfer_to_number": {
        "type": "system", "name": "transfer_to_number", "description": "",
        "params": {
          "system_tool_type": "transfer_to_number",
          "transfers": [],
          "transfer_rules": [{
            "condition": "the caller asks to speak with a human",
            "provider_configs": [
              {"type": "voximplant", "config": {"type": "voximplant_handoff"}}
            ]
          }]
        }
      }
    }}}}
  }'

Skicka agentens fullständiga built_in_tools-objekt, inklusive verktyg som den redan har, till exempel end_call. Alternativet som agenten skickar tillbaka är den fasta token voximplant, så en Voximplant-regel per verktyg räcker. Telefonnummer och SIP-URI:er som konfigurerats för andra leverantörer erbjuds inte i Voximplant- samtal.

Skapa en dedikerad API-nyckel

Skapa en API-nyckel i samma arbetsyta som agenten och begränsa den till ElevenAgents. För att endast acceptera anslutningar från Voximplant begränsar du nyckelns tillåtna IP-adresser till Voximplants medieservrar, som Voximplant listar på https://api.voximplant.com/getMediaResources?with_mediaservers.

Notera WebSocket-URL:en

Scenariot ansluter till en URL som innehåller ditt agent-ID:

För att låsa en gren av agenten lägger du till ?branch_id=<branch_id>.

Skapa en applikation

I Voximplant-kontrollpanelen öppnar du Applications och klickar på Create application. Ge den ett namn, till exempel elevenlabs-agent, och klicka på Create.

Spara API-nyckeln som en hemlighet

I applikationen öppnar du Secrets och klickar på Add secret. Ge den namnet ELEVENLABS_API_KEY, klistra in API-nyckeln som du skapade för agentens arbetsyta i Value och klicka på Add secret. Scenariot läser den med VoxEngine.getSecretValue(), så nyckeln visas aldrig i scenariokoden.

Skapa scenariot

Öppna Scenarios, klicka på Create scenario, ge det namnet elevenlabs_agent, klistra in koden nedan, ersätt agent-ID:t i ELEVENLABS_URL och klicka på Save. Det besvarar ett inkommande samtal, strömmar samtalet till agenten och agerar på beslutet när samtalet avslutas. För ett utgående samtal öppnar du WebSocket-anslutningen i hanteraren CallEvents.Connected för samtalet du ringde upp.

const ELEVENLABS_URL =
  "wss://api.elevenlabs.io/v1/convai/conversation/voximplant/agent_7101k5zvyjhmfg983brhmhkd98n6";
VoxEngine.addEventListener(AppEvents.CallAlerting, ({ call }) => {
  call.answer();
  let decision = null;
  const ws = VoxEngine.createWebSocket(ELEVENLABS_URL, {
    headers: [
      {
        name: "Authorization",
        value: `Bearer ${VoxEngine.getSecretValue("ELEVENLABS_API_KEY")}`,
      },
    ],
  });
  ws.addEventListener(WebSocketEvents.OPEN, () => {
    call.sendMediaTo(ws, {
      encoding: WebSocketAudioEncoding.PCM16_8KHZ,
      customParameters: { customer_name: "Ana", task_id: "task-7" },
    });
    ws.sendMediaTo(call);
  });
  ws.addEventListener(WebSocketEvents.MESSAGE, ({ text }) => {
    const message = JSON.parse(text);
    if (message.customEvent === "elevenlabs-decision") {
      decision = message.payload;
      Logger.write(`ElevenLabs decision: ${JSON.stringify(decision)}`);
    }
  });
  ws.addEventListener(WebSocketEvents.CLOSE, (e) => {
    Logger.write(`ElevenLabs socket closed: code=${e.code} reason=${e.reason}`);
    if (decision?.action === "transfer-to-agent") {
      // Route the caller to a human here, for example with VoxEngine.callPSTN().
      call.say("Connecting you to an agent.", { language: VoiceList.Amazon.en_US_Joanna });
      call.addEventListener(CallEvents.PlaybackFinished, () => call.hangup());
      return;
    }
    call.hangup();
  });
  call.addEventListener(CallEvents.Disconnected, () => {
    ws.close();
    VoxEngine.terminate();
  });
});

Dirigera samtal till scenariot

Öppna Routing, klicka på Create rule, ge regeln ett namn och tilldela scenariot elevenlabs_agent. Standardmönstret .* skickar varje samtal till applikationen via scenariot; begränsa det till ett telefonnummer om applikationen även hanterar andra samtal. För att dirigera ett telefonnummer kopplar du det till applikationen under Numbers.

Ring ett testsamtal

Du kan ringa applikationen från webbläsaren utan ett telefonnummer:

1. Öppna Users, klicka på Create user och skapa en användare med ett lösenord.

   

2. I Routing klickar du på Test tools och sedan på Softphone. Logga in som den användaren, tillåt åtkomst till mikrofonen, ange valfri destination och ring. Agenten svarar med sitt första meddelande.

3. När samtalet avslutas öppnar du Call history. Varje samtal visar en WebSocket-koppling bredvid själva samtalet. Klicka på View log för att se sessionen.

   

   Loggen visar beslutet som ElevenLabs skickade, när WebSocket-anslutningen stängdes och vad scenariot gjorde sedan. I det här exemplet bad uppringaren om en person, så beslutet är transfer-to-agent med skälet som agenten angav.