Pre-Call Data Fetch

​

Como funciona

1. Uma chamada chega.
2. A Tig.ai envia uma requisição POST ao seu endpoint configurado com um payload padronizado.
3. O chamador ouve um tom de ring-back enquanto espera pela resposta.
4. Sua API responde com um objeto JSON contendo um objeto initial_context.
5. As variáveis são mescladas no contexto inicial da chamada.
6. O agente de voz começa com acesso total aos dados buscados por meio da sintaxe {{variable_name}}.

​

Configuração

​

Formato da requisição

{
  "event": "call_inbound",
  "call_inbound": {
    "agent_id": 123,
    "from_number": "+12137771234",
    "to_number": "+12137771235"
  }
}

​

Formato esperado da resposta

{
  "call_inbound": {
    "initial_context": {
      "customer_name": "Jane Doe",
      "account_status": "active",
      "loyalty_tier": "gold",
      "open_tickets": 2
    }
  }
}

{
  "initial_context": {
    "customer_name": "Jane Doe",
    "account_status": "active"
  }
}

• Saudação: Hello {{customer_name}}, thank you for calling!
• Prompt: The customer is a {{loyalty_tier}} member with {{open_tickets}} open support tickets.

​

Variáveis aninhadas

{
  "call_inbound": {
    "initial_context": {
      "customer": {
        "name": "Jane Doe",
        "address": {
          "city": "Los Angeles"
        }
      }
    }
  }
}

​

Timeout

​

Testando com chamadas de teste

1. Abra seu workflow e vá para Settings.
2. Em Context Variables, adicione as seguintes variáveis:
   • caller_number — definida como um número de telefone que você quer simular como chamador (por exemplo, +12137771234).
   • called_number — definida como o número que seria discado (por exemplo, +12137771235).
3. Salve as configurações.

​

Exemplo de integração

app.post("/tig/pre-call", async (req, res) => {
  const { call_inbound } = req.body;

  const customer = await db.customers.findOne({
    phone: call_inbound.from_number,
  });

  if (!customer) {
    return res.json({});
  }

  res.json({
    call_inbound: {
      initial_context: {
        customer_name: customer.name,
        account_status: customer.status,
        loyalty_tier: customer.tier,
      },
    },
  });
});