> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tigyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integração de Telefonia

> Conecte agentes de voz a provedores de telefonia para chamadas recebidas

## Visão geral

A integração de telefonia da Tig.ai fornece uma interface unificada para conectar provedores suportados e rotear chamadas recebidas para seus agentes.

## Provedores suportados

<CardGroup cols={3}>
  <Card title="Twilio" href="/pt/integrations/telephony/twilio">
    Plataforma de comunicações em nuvem líder do setor, com alcance global
  </Card>

  <Card title="Telnyx" href="/pt/integrations/telephony/telnyx">
    Receba chamadas por meio do Telnyx Call Control
  </Card>

  <Card title="SIP" href="/pt/integrations/telephony/sip">
    Receba chamadas por meio do número SIP atribuído a um agente
  </Card>
</CardGroup>

## Configuração

Todos os provedores de telefonia são configurados em uma única página na Tig.ai:

1. Navegue até **/telephony-configurations** e clique em **Add configuration**
2. Selecione seu provedor
3. Informe suas credenciais e salve
4. Abra a nova configuração e adicione pelo menos um **phone number**
5. (Opcional) Atribua um **Inbound workflow** a um número de telefone para ativar chamadas recebidas

Um único workspace pode conter várias configurações e vários números de telefone por configuração. Atribua um workflow de entrada a cada número que deve receber chamadas.

## Recursos comuns

A integração de telefonia na Tig.ai suporta:

* **Chamadas recebidas (Inbound Calls)**: roteie chamadas recebidas para o agente de voz certo — veja o guia [Chamadas Recebidas](/pt/integrations/telephony/inbound)
* **Transferência de chamada**: transfira uma chamada em andamento para um humano ou outro número (depende do provedor)
* **Rastreamento de status da chamada**: monitore os eventos do ciclo de vida da chamada (iniciada, tocando, atendida, concluída, falha)
* **Streaming de áudio via WebSocket**: áudio bidirecional em tempo real entre chamador e agente
* **Verificação de assinatura de webhook**: os webhooks recebidos são verificados em relação às credenciais da configuração correspondente

## Chamadas recebidas

As chamadas recebidas usam uma **URL de webhook única por organização**:

```
https://api.tig.ai/api/v1/telephony/inbound/run
```

A Tig.ai identifica a organização pelas credenciais de conta do webhook e o agente pela atribuição de **Inbound workflow** do número chamado. Consulte [Chamadas Recebidas](/pt/integrations/telephony/inbound) para a configuração completa.

## Solução de problemas

<AccordionGroup>
  <Accordion title="Chamadas não conectam">
    * Verifique se as credenciais estão configuradas corretamente
    * Cheque o formato do número de telefone ([E.164](https://en.wikipedia.org/wiki/E.164) — o padrão internacional: um `+`, depois o código do país, depois o número, sem espaços ou hifens, por exemplo `+1234567890`)
    * Garanta que as URLs de webhook sejam acessíveis publicamente
    * Revise os logs de erro específicos do provedor
  </Accordion>

  <Accordion title="Problemas de qualidade de áudio">
    * Cheque a largura de banda e a latência da rede
    * Verifique a compatibilidade do codec de áudio
    * Revise a estabilidade da conexão WebSocket
  </Accordion>

  <Accordion title="Falha na validação da assinatura do webhook">
    * Confirme se os tokens de autenticação / segredos de API correspondem entre o provedor e a configuração da Tig.ai
    * Verifique se a URL do webhook corresponde exatamente (incluindo o caminho `/inbound/run`)
    * Cheque se há modificações por proxy ou balanceador de carga
  </Accordion>
</AccordionGroup>

## Próximos passos

* [Configure seu primeiro provedor de telefonia](/pt/integrations/telephony/twilio)
* [Configure chamadas recebidas](/pt/integrations/telephony/inbound)