Personalizar ligação com IA usando variáveis na API

Uma ligação genérica soa como propaganda. Uma ligação que começa pelo nome da pessoa e vai direto ao assunto dela soa como atendimento. Para personalizar ligação com IA na respondendo.app, você não precisa de um roteiro por cliente: basta mandar as informações daquela pessoa como variáveis no pedido, e o agente usa cada uma no ponto certo da conversa.

Neste artigo você vai ver como as variáveis funcionam, como escrever o roteiro para usá-las e quais cuidados evitam uma conversa estranha quando algum dado falta.

Como funcionam as variáveis

No pedido da ligação, o campo variaveis é um objeto com pares de nome e valor. Por exemplo, primeiro_nome com o valor Antônio e visita com o valor quinta às 15h. No roteiro do agente, você marca onde cada valor entra escrevendo o nome da variável entre chaves duplas, como {{primeiro_nome}}.

Quando a ligação começa, a plataforma troca as marcações pelos valores daquela pessoa. O mesmo agente atende milhares de contatos, e cada conversa sai com os dados certos. A página do JSON mostra o pedido mínimo, e a documentação da API traz os exemplos completos.

O pedido da ligação, passo a passo

1. Crie a chave de API no painel. Ela vai no cabeçalho Authorization: Bearer de cada pedido.
2. Escolha o agente e anote o id dele.
3. Monte o JSON com telefone, agente_id, variaveis e, se quiser receber o resultado automaticamente, webhook_url.
4. Envie o POST para /v1/ligacoes. A resposta chega na hora com o id da ligação.
5. Receba o resultado no webhook ou consulte pela rota da ligação.

As variáveis também voltam no resultado, o que facilita cruzar a ligação com o cadastro de origem.

Como personalizar ligação com IA no roteiro

Ter a variável não basta: o roteiro precisa usá-la bem. Algumas orientações:

• Use o nome na abertura e quase mais nada. Repetir o nome em toda fala soa artificial.
• Coloque o motivo da ligação logo no começo. "É sobre a sua visita de {{visita}}" mostra que a ligação tem a ver com a pessoa.
• Dê contexto à IA, não só à fala. Variáveis como o plano atual ou o último produto comprado ajudam a IA a responder melhor, mesmo que não sejam ditas em voz alta.
• Explique o que cada variável significa. Uma linha no roteiro dizendo o que é cada informação evita interpretações erradas.

Quando um dado falta

Na vida real, nem todo cadastro está completo. Pense nisso ao escrever o roteiro:

• Diga o que fazer sem o dado. Por exemplo: se o nome não vier, cumprimente sem nome e pergunte com quem está falando.
• Valide antes de enviar. O seu sistema pode deixar de pedir a ligação quando faltar algo essencial, como o horário de uma consulta que se quer confirmar.
• Mande os valores no formato falado. "quinta às 15h" funciona melhor que um código de data, porque a IA vai dizer aquilo para a pessoa.

Variáveis com ferramentas e integrações

As variáveis trazem o que você já sabe antes da ligação. O que só se descobre durante a conversa, como um horário livre na agenda, vem das ferramentas, que deixam a IA consultar o seu sistema ao vivo. Os dois recursos se completam: as variáveis abrem a conversa com contexto, e as ferramentas trazem o dado atualizado na hora.

Quem não programa também personaliza: nas listas de contatos do painel, cada coluna da planilha vira uma variável do roteiro, e as integrações com formulários e plataformas de venda já mandam os dados do contato.

Exemplo: uma clínica que confirma retornos

O sistema da clínica fictícia do doutor André chama a API toda tarde para os retornos do dia seguinte. Cada pedido leva o primeiro nome do paciente, o nome do médico e o horário. O roteiro abre com "Oi, {{primeiro_nome}}, aqui é da clínica, é sobre o seu retorno com o doutor {{medico}} amanhã, {{horario}}" e pergunta se a pessoa confirma.

Quando o paciente pede para remarcar, a IA registra o resultado com a anotação do melhor período. O webhook devolve as mesmas variáveis, e o sistema da clínica sabe exatamente qual consulta mudar.

Perguntas frequentes

Existe limite de variáveis por ligação?

Mande as que o roteiro realmente usa. Variáveis demais deixam o contexto confuso e não melhoram a conversa.

Posso usar variáveis em um modelo pronto?

Pode. Edite o roteiro do agente criado a partir do modelo e acrescente as marcações onde quiser.

As variáveis aparecem no resultado?

Sim. Elas voltam no webhook e na consulta da ligação, junto com o resumo, a transcrição e o resultado.

Faça a sua primeira ligação personalizada

Crie sua conta com o Google, gere a chave de API no painel e mande um pedido com o seu próprio nome nas variáveis. Ouvir a IA dizer o seu nome é o jeito mais rápido de entender como personalizar ligação com IA. Veja também como funciona a ligação do pedido ao resultado.