> ## 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.

# Chamadas & Execuções

> O ciclo de vida de uma chamada e como os runs capturam seus resultados

Toda vez que um workflow é executado, a Tig.ai cria um **run**. O run é o registro dessa execução: o que foi dito, quais dados foram coletados, quanto tempo levou e quanto custou.

## Chamadas vs runs

Uma **chamada** é a conexão de áudio — seja pelo telefone por meio de um provedor de telefonia, seja pelo navegador por meio de uma Web Call.

Um **run** é o registro da execução do workflow na Tig.ai. Toda conversa recebida por telefone ou navegador cria um run contendo a transcrição, a gravação, o contexto coletado, o uso e o custo.

## Ciclo de vida da chamada

O ciclo de vida da chamada acompanha a conexão telefônica — desde o momento em que um número é discado até quando a linha cai.

```mermaid theme={null}
stateDiagram-v2
    [*] --> Ringing: Número discado
    Ringing --> Connected: Chamador atende
    Ringing --> Ended: Sem resposta
    Connected --> Ended: Conversa concluída
    Connected --> Ended: Erro ou desconexão
    Ended --> [*]
```

Para chamadas recebidas, o fluxo começa quando o chamador disca e o provedor de telefonia roteia a chamada para a Tig.ai.

## Chamadas recebidas (inbound)

As chamadas recebidas são iniciadas pelo chamador. Seu provedor de telefonia roteia as chamadas de entrada para um agente da Tig.ai por meio de uma URL de webhook. Use-as para linhas de suporte, linhas diretas e substituição de URA (IVR).

## Web Calls

A Web Call permite falar com seu agente diretamente do navegador — sem número de telefone ou configuração de telefonia. Ela executa o pipeline completo: STT, LLM, TTS, gravação e transcrição, exatamente como uma chamada telefônica.

Use-a para testar seu agente antes de ir ao ar. A visualização do run mostra a transcrição ao vivo conforme a conversa avança, as transições de nós conforme o workflow se move pelo grafo e quaisquer chamadas de ferramentas ou funções que o agente fizer em tempo real.

## O que um run contém

Depois que uma chamada termina, o registro do run inclui:

| Campo              | Descrição                                                  |
| ------------------ | ---------------------------------------------------------- |
| `status`           | Estado final do run                                        |
| `recording_url`    | URL de download do áudio da chamada                        |
| `transcript_url`   | URL de download da transcrição da conversa                 |
| `gathered_context` | Dados estruturados extraídos pelo agente durante a chamada |
| `initial_context`  | Os dados disponíveis quando a conversa começa              |
| `usage_info`       | Duração em segundos, contagem de tokens                    |
| `cost_info`        | Custo em USD                                               |