---
title: "Centros de contato"
description: "Envie chamadas do Amazon Connect, Five9, Genesys Cloud, Talkdesk, Twilio, Microsoft Dynamics 365, NICE CXone ou Zoom Contact Center para um agente ThunderPhone via SIP e receba-as de volta com a transferência do agente."
---

Um agente ThunderPhone pode atender chamadas dentro do fluxo de chamadas da sua central de contato.
Sua plataforma envia a chamada ao [endereço SIP](/pt/guides/sip-addresses) do agente
com cabeçalhos SIP que levam seu próprio ID de chamada e qualquer outra informação que ela tenha sobre
quem liga. Quando quem liga precisa de uma pessoa, o agente devolve a chamada com
uma transferência: um resumo do que quem liga precisa, um rótulo curto de intenção e um ID
que seu fluxo pode consultar.

## Plataformas

| Plataforma | Como a chamada chega | Cabeçalho de ID da chamada | Como ela retorna | Como o contexto retorna |
|---|---|---|---|---|
| [Amazon Connect](/pt/guides/contact-centers/amazon-connect) | Conector externo de transferência de voz; lista de IPs permitidos | `X-Amzn-ConnectContactId` | Retorno: o agente encerra a chamada e o fluxo é retomado | Uma Lambda chama a consulta da transferência |
| [Five9](/pt/guides/contact-centers/five9) | AI Agent Connect, configurado pela Five9, para um número de discagem; lista de IPs permitidos | `X-CallID` | Retorno: o agente encerra a chamada com cabeçalhos de roteamento no `BYE` | Cabeçalhos `X-Route*` e `X-CustomMetaData` em variáveis de chamada da URA |
| [Genesys Cloud](/pt/guides/contact-centers/genesys-cloud) | Tronco BYOC Cloud; digest | `x-inin-cnv` | `REFER`, aceito por Retomar e transferir | UUI hexadecimal dentro do endereço de transferência, depois uma ação de dados |
| [Talkdesk](/pt/guides/contact-centers/talkdesk) | Conexão ao Autopilot Voice; lista de IPs permitidos | `X-Talkdesk-Interaction-Id` | `REFER` para o endereço de escalonamento da Talkdesk | UUI hexadecimal dentro do endereço de transferência, depois Executar ação |
| [Twilio](/pt/guides/contact-centers/twilio) | `<Dial><Sip>`; digest | `X-Call-ID`, que você adiciona | `REFER` para seu manipulador `referUrl` | Cabeçalhos dentro do endereço de transferência (`ReferTransferTarget`) |
| [Microsoft Dynamics 365](/pt/guides/contact-centers/microsoft-dynamics-365) | Transferência para um número de telefone, pelo seu SBC; digest | `X-Call-ID`, que você adiciona | Retorno, depois seu SBC encaminha quem liga de volta | O nó Solicitação HTTP chama a consulta da transferência |
| [NICE CXone](/pt/guides/contact-centers/nice-cxone) | Studio `Placecall` com `Sipputheader`, para um número de discagem; lista de IPs permitidos | `X-Call-ID`, que você adiciona | Retorno: o agente encerra a chamada (confirme com a NICE como o script retorna quem liga) | Ação da API REST chama a consulta da transferência |
| [Zoom Contact Center](/pt/guides/contact-centers/zoom-contact-center) | Widget de bot em um tronco criado pela Zoom, para um número de discagem; lista de IPs permitidos com SRTP | `X-ZOOM-Call-Sid` | `REFER` para o endereço de agente humano da Zoom | O widget Chamada HTTP chama a consulta da transferência |

## Como funciona

1. **Crie um endpoint SIP** para o agente, com a API, em **Telefone e web**
   → **Endpoints SIP** no aplicativo ou perguntando ao Zeus. Plataformas que podem responder a um
   desafio de senha usam o nome de usuário e a senha do endpoint. Plataformas que
   se identificam apenas por seus endereços de origem usam um endpoint com
   `auth` definido como `ip_allowlist`; consulte
   [Plataformas que autenticam por IP de origem](/pt/guides/sip-addresses).
   Plataformas que discam um número de telefone em vez de um endereço SIP acessam o
   endpoint por meio de seus
   [números de discagem](/pt/guides/sip-addresses).
2. **Envie chamadas com contexto.** A plataforma disca o `sip_uri` do endpoint ou
   um número de discagem.
   Todo cabeçalho `X-` e `User-to-User` que ela envia se torna uma variável de chamada
   `{{sip_…}}` que o prompt pode usar, e o cabeçalho de ID da chamada é armazenado como o
   `external_call_id` da chamada. Consulte
   [Passar contexto da chamada em cabeçalhos SIP](/pt/guides/sip-addresses).
3. **Adicione um número de transferência que devolva a chamada**, seja um endereço SIP
   na sua plataforma (o agente envia um `REFER`) ou um
   [retorno](/pt/guides/call-transfers)
   (o agente desliga e seu fluxo continua). Os cabeçalhos dele podem transportar
   `{{handoff_summary}}`, `{{handoff_intent}}` e `{{handoff_id}}`; consulte
   [Passar contexto para sua central de atendimento](/pt/guides/call-transfers).
4. **Leia a transferência** onde sua plataforma a coloca ou pesquise-a pelo ID da chamada
   da sua plataforma.

### Adicione o número de transferência

Endereços SIP, retornos e seus cabeçalhos são configurados com a
[API de Agents](/api-reference/agents#transfer-numbers). Uma gravação substitui a
lista inteira, portanto inclua os outros números de transferência do agente e depois implante:

```bash
curl -X PATCH https://api.thunderphone.com/v1/agents/12 \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"transfer_destinations": [{"name": "Contact center", "action": "return"}]}'

curl -X POST https://api.thunderphone.com/v1/agents/12/deploy \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

Em seguida, informe ao agente quando usá-lo, pelo nome, no prompt: "Quando quem liga
pedir para falar com uma pessoa ou você não conseguir resolver a solicitação, transfira para a
central de atendimento."

### Procure a transferência

Seu fluxo pode buscar a transferência usando a chave de API da sua organização e o ID
da chamada da sua plataforma:

```bash
curl "https://api.thunderphone.com/v1/calls/handoff?external_call_id=YOUR_PLATFORM_CALL_ID" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

A resposta inclui `handoff.summary`, `handoff.intent` e `handoff.handoff_id`,
os cabeçalhos SIP e as variáveis com que a chamada começou e, quando a chamada tiver
terminado, seu resumo e os dados extraídos. Você também pode procurar uma chamada por
`handoff_id`. Consulte
[Procure uma chamada transferida](/api-reference/calls#look-up-a-handed-off-call).

Mantenha a chave de API no armazenamento de credenciais da sua plataforma, não no próprio fluxo.

<Warning>
  Os valores dos cabeçalhos vêm de quem envia a chamada. Use-os como contexto no
  prompt, não para decidir quem é quem liga ou o que essa pessoa pode fazer.
</Warning>

## Guias

<CardGroup cols={2}>
  <Card title="Amazon Connect" icon="phone" href="/pt/guides/contact-centers/amazon-connect">
    Transferência de voz externa para entrada, retorno e uma consulta Lambda de volta.
  </Card>
  <Card title="Five9" icon="phone" href="/pt/guides/contact-centers/five9">
    AI Agent Connect para entrada, cabeçalhos de roteamento no desligamento de volta.
  </Card>
  <Card title="Genesys Cloud" icon="phone" href="/pt/guides/contact-centers/genesys-cloud">
    Tronco BYOC Cloud para entrada, Take Back e Transfer com UUI de volta.
  </Card>
  <Card title="Talkdesk" icon="phone" href="/pt/guides/contact-centers/talkdesk">
    Conexão ao Autopilot Voice para entrada, escalonamento com UUI de volta.
  </Card>
  <Card title="Twilio" icon="phone" href="/pt/guides/contact-centers/twilio">
    TwiML Dial para entrada, um REFER ao seu manipulador referUrl de volta.
  </Card>
  <Card title="Microsoft Dynamics 365" icon="phone" href="/pt/guides/contact-centers/microsoft-dynamics-365">
    Transferência pelo seu SBC para entrada, retorno e uma consulta HTTP de volta.
  </Card>
  <Card title="NICE CXone" icon="phone" href="/pt/guides/contact-centers/nice-cxone">
    Studio Placecall para entrada, retorno e uma consulta REST de volta.
  </Card>
  <Card title="Zoom Contact Center" icon="phone" href="/pt/guides/contact-centers/zoom-contact-center">
    Widget de bot para entrada, um REFER a um agente humano de volta.
  </Card>
</CardGroup>
