---
title: "Forbind fra Twilio"
description: "Send Twilio-opkald til en ThunderPhone-agent via SIP med CallSid, og tag dem tilbage via din referUrl med overdragelsen i overførselsadressen."
---

Din TwiML ringer op til agentens SIP-adresse med opkaldets `CallSid` i en header.
Når opkalderen har brug for en person, sender agenten en SIP-`REFER`, Twilio sender
overførselsadressen med overdragelsen i den til din `referUrl`-behandler, og den
TwiML, som din behandler returnerer, afgør, hvor opkalderen ender, f.eks. i en Flex-kø.

## Før du starter

- En ThunderPhone-agent og en organisations-[API-nøgle](/da/guides/api-keys).
- Twilio Programmable Voice og et sted at levere TwiML og en `referUrl`-
  behandler: din egen server eller en TwiML Bin og en Twilio Function. Flex er
  valgfrit.

## 1. Opret SIP-slutpunktet

Twilios `<Sip>` bruger et brugernavn og en adgangskode, så brug et standardendpunkt:

```bash
curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": 12, "name": "Twilio"}'
```

Gem `password` fra svaret med det samme; den vises kun én gang. Hvis du også kun
vil acceptere opkald fra Twilio, se
[Begræns kilde-IP-adresser](/da/guides/sip-addresses).

## 2. Send opkald med kontekst

Returnér denne TwiML for det opkald, du vil overdrage til agenten:

```xml
<Response>
  <Dial answerOnBridge="true" referUrl="https://YOUR_SERVER/thunderphone-refer">
    <Sip username="tp409667538f83" password="YOUR_ENDPOINT_PASSWORD">sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls?X-Call-ID={{CallSid}}</Sip>
  </Dial>
</Response>
```

- `;transport=tls` er vigtigt: Twilio bruger UDP, medmindre du angiver andet.
- `X-Call-ID` indeholder `CallSid`. Twilio dokumenterer ikke en egen call-id-header,
  så tilføj denne: ThunderPhone gemmer den som opkaldets
  `external_call_id`. `{{CallSid}}` virker i en TwiML Bin; fra din egen server
  skal du skrive `CallSid` fra den indgående anmodning.
- Tilføj mere kontekst på samme måde, f.eks. `&amp;X-Account-Id=12345`. Inde i
  TwiML skal du skrive `&` som `&amp;`, da et nøgent `&` er ugyldig XML. Hver
  når prompten som en variabel, her `{{sip_x_account_id}}`. Twilio tillader
  `x-`-headere og `User-to-User`, procentkodet, med hele URI'en på under 255 tegn
  og headerne på under 1.024.
- `referUrl` lader Twilio acceptere agentens `REFER`; uden den mislykkes
  overførslen med [fejl 13802](https://www.twilio.com/docs/api/errors/13802).
  `answerOnBridge="true"` holder opkalderen forbundet, indtil den nye destination
  svarer, så en mislykket overførsel kan falde tilbage.

Studios **Forbind opkald til**-widget dokumenterer ikke brugerdefinerede headere
eller `referUrl`, så overdrag opkaldet fra Studio til denne TwiML, f.eks. med en
**TwiML-omdirigering**-widget.

## 3. Få opkaldet tilbage

Agenten overfører med en `REFER`, hvis overførselsadresse indeholder
overdragelses-id og hensigt. Tilføj dette overførselsnummer (se
[Tilføj overførselsnummeret](/da/guides/contact-centers/overview)
og [Headere i overførselsadressen](/da/guides/call-transfers)):

```json
{
  "name": "Twilio support",
  "number": "sip:support@acme.sip.twilio.com",
  "headers": {"X-Handoff-Id": "{{handoff_id}}", "X-Handoff-Intent": "{{handoff_intent}}"},
  "headers_in_uri": true
}
```

Twilio sender hele adressen til din `referUrl` som `ReferTransferTarget`, for
eksempel `<sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>`.
Din handler læser headerne ud af den og returnerer TwiML for, hvor opkalderen
sendes hen derefter. Adressens brugerdel (`support`) vælger du selv, så du kan
tilføje ét overførselsnummer pr. destination og route ud fra det.

Denne Twilio Function sætter opkalderen i kø til Flex med overdragelsen som
opgaveattributter og slår resuméet op efter overdragelses-id. Opslaget kører i
en Function, fordi Studios HTTP Request-widget ikke kan sende headeren
`Authorization`:

```js
exports.handler = async (context, event, callback) => {
  const target = (event.ReferTransferTarget || "").replace(/^<|>$/g, "");
  const params = new URLSearchParams(target.split("?")[1] || "");
  const handoffId = params.get("X-Handoff-Id") || "";
  const attributes = { handoff_id: handoffId, intent: params.get("X-Handoff-Intent") || "" };

  if (handoffId) {
    const response = await fetch(
      "https://api.thunderphone.com/v1/calls/handoff?handoff_id=" + encodeURIComponent(handoffId),
      { headers: { Authorization: "Bearer " + context.THUNDERPHONE_API_KEY } }
    );
    if (response.ok) {
      const call = await response.json();
      attributes.summary = (call.handoff && call.handoff.summary) || "";
    }
  }

  const twiml = new Twilio.twiml.VoiceResponse();
  twiml.enqueue({ workflowSid: context.FLEX_WORKFLOW_SID }).task({}, JSON.stringify(attributes));
  callback(null, twiml);
};
```

Gem API-nøglen i Function-miljøvariablerne. Se
[Slå et overdraget opkald op](/api-reference/calls#look-up-a-handed-off-call)
for de øvrige felter.

## Test det

Ring til et Twilio-nummer, der returnerer TwiML-koden ovenfor, bed agenten om
en person, og kontrollér, at din `referUrl`-handler modtager
`ReferTransferTarget` med begge headere, og at opkalderen når køen. Åbn derefter
opkaldet med `GET /v1/calls/{call_id}`: `external_call_id` skal være `CallSid`.

## Begrænsninger

- Twilio begrænser `Refer-To` til 256 tegn. ThunderPhone holder adressen på
  254 og udelader en header, der ikke passer, så hold headernavne og værdier
  korte.
- Twilio dokumenterer ikke læsning af headere på en `BYE`, så en returnering kan
  ikke føre overdragelsen tilbage til Twilio. Brug en `REFER` som ovenfor.
- Twilio accepterer ikke en `REFER` på et opkald, der er forbundet via
  `<Conference>` eller `<Queue>`, så ring til agenten med `<Dial><Sip>` som
  ovenfor.
