---
title: "Conectar a partir do Five9"
description: "Envie chamadas do Five9 para um agente do ThunderPhone por SIP com o AI Agent Connect e receba-as de volta com cabeçalhos de roteamento lidos pelo seu script de URA."
---

O script de URA do Five9 encaminha quem liga ao agente com os detalhes da
chamada do Five9. Quando o agente termina, ele encerra a chamada com cabeçalhos
de roteamento no SIP `BYE`, que o script lê em variáveis da chamada para
encaminhar quem liga.

## Antes de começar

- Um agente ThunderPhone e uma [chave de API](/pt/guides/api-keys) da organização.
- O complemento **AI Agent Connect** do Five9. O Five9 o limita a provedores de
  IA que credenciou, e a equipe de implementação do Five9 o configura: ela
  importa o modelo de script de URA do provedor, cria as variáveis da chamada e
  aponta o módulo **Transferência para Terceiros** do script para o provedor. O
  ThunderPhone ainda não está na lista de credenciados do Five9: consulte sua
  equipe de conta do Five9 ou o suporte do ThunderPhone antes de planejar com
  base nisso.

## 1. Crie o endpoint SIP

O módulo de Transferência para Terceiros do Five9 disca um número de telefone,
não um endereço SIP, e as integrações do Five9 de outros provedores autenticam
o Five9 pelo endereço de origem, e não por uma senha. Portanto, crie um
endpoint `ip_allowlist` com o número que o Five9 discará como um número de
discagem de entrada (consulte
[Plataformas que discam um número de telefone](/pt/guides/sip-addresses)):

```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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`: os intervalos de sinalização SIP dos seus data
  centers do Five9, fornecidos pelo Five9. Cada um deve ser um intervalo IPv4
  público de `/16` ou mais restrito (IPv6 `/48` ou mais restrito).
- `dial_in_numbers`: o número que o script do Five9 discará, escrito da forma
  como o Five9 o envia. Ele não precisa ser um número de telefone real. Ele não
  pode já estar em uso no ThunderPhone, como número de telefone ou em outro
  endpoint: isso retorna `409`.

Os endereços do Five9 são compartilhados por todos os seus clientes, portanto
qualquer outro cliente do Five9 que discar o número chegará ao seu agente. Ao
escolher o número, escolha um longo que ninguém adivinharia (até 15 dígitos),
garanta que o Five9 o envie ao ThunderPhone em vez de encaminhá-lo para a rede
telefônica e não o publique.

## 2. Envie chamadas com contexto

Peça à equipe de implementação do Five9 para:

- Enviar a chamada do módulo **Transferência para Terceiros** para
  `sip:+14155550188@sip.thunderphone.com`, com o número tanto na URI de
  solicitação quanto no cabeçalho `To`. O módulo recebe o número, com o domínio
  SIP do provedor em um cabeçalho.
- Enviá-la por TLS (porta 5061) ou TCP (porta 5060). O endpoint recusa UDP, e
  o Five9 não informa qual transporte usa; portanto, garanta que não seja UDP.
- Ativar **Retornar após chamada de terceiros**, para que o script continue
  quando o agente encerrar a chamada (o Five9 permite até 3.600 segundos na
  chamada de terceiros).

O guia do Five9 lista os valores que ele envia (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` e outros), mas não os
nomes dos cabeçalhos. As integrações do Five9 de outros provedores de IA os
documentam no tráfego como `X-CallANI`, `X-CallDNIS`, `X-CallID`,
`X-CallSessionID`, `X-CallCampaign` e `X-AgentID`; verifique-os na sua primeira
chamada de teste. Cada um chega ao prompt como uma variável, como
`{{sip_x_callcampaign}}`. `X-CallID` é armazenado como o
`external_call_id` da chamada.

## 3. Receba a chamada de volta

O agente devolve a chamada: ele se despede e encerra a chamada, e o `BYE` contém
os quatro cabeçalhos que o script do Five9 lê. Adicione este número de transferência (consulte
[Adicionar o número de transferência](/pt/guides/contact-centers/overview)):

```json
{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
```

- `X-RouteType` e `X-RouteValue` informam ao script para onde enviar quem liga,
  neste caso, a habilidade Support. Os valores que outros provedores documentam para `X-RouteType` incluem
  `SkillTransfer`, `PhoneTransfer`, `Hangup` e `DispositionOnly`; combine os
  valores com quem mantém o script. Para vários destinos, adicione um
  retorno por destino com um nome e `X-RouteValue` diferentes.
- `X-RouteReason` contém o rótulo da intenção do agente, como `billing_dispute`.
- `X-CustomMetaData` contém o ID da transferência. O `BYE` também o contém como
  `X-TP-Handoff-Id`, que o Five9 não lê.

O script do Five9 mapeia os quatro cabeçalhos para variáveis da chamada. Para o
resumo do agente, faça o script chamar a consulta de transferência com um módulo de URA **Consulta**:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` seguido de
`call.call_id`, com um Perfil de autorização que envie
`Authorization: Bearer` e sua chave de API. Consulte
[Consultar uma chamada transferida](/api-reference/calls#look-up-a-handed-off-call).

## Teste

Ligue para o script de URA, peça ao agente para transferir para uma pessoa e verifique se o script
encaminha quem liga com as variáveis da chamada preenchidas. Se a chamada nunca chegar ao
agente, verifique se o número no URI da solicitação e no cabeçalho `To` corresponde ao
número de discagem, se o endereço de origem do Five9 está em `allowed_source_cidrs` e
se a chamada ocorreu por TCP ou TLS. Em seguida, abra a chamada com
`GET /v1/calls/{call_id}`: `sip_headers` deve listar `x-callid`, e
`external_call_id` deve corresponder a `call.call_id` no Five9.

## Limites

- O guia do Five9 documenta dados de roteamento no `BYE` e não menciona
  a aceitação de um `REFER`, portanto a devolução é uma transferência fria pelo script.
- O Five9 lê `X-RouteType`, `X-RouteValue`, `X-RouteReason` e
  `X-CustomMetaData`, não `User-to-User`. O ThunderPhone envia cada valor de cabeçalho
  com no máximo 256 bytes.
- O Five9 recomenda manter cerca de dez cabeçalhos personalizados para evitar a
  fragmentação de pacotes.
