respondendo.app
  1. 1

    POST na API

    Telefone, agente e variáveis num JSON. A resposta chega na hora, com o id da ligação.

  2. 2

    A ligação sai

    Sai de um número com o DDD da pessoa, o que aumenta a chance de ela atender.

    ~1,2 s para tocar
  3. 3

    A pessoa atende

    A IA fala com o seu roteiro, usando as variáveis, e ouve a resposta como numa conversa.

  4. 4

    Ferramenta chamada

    Quando precisa de um dado seu, a IA chama a sua URL e continua com a resposta.

  5. 5

    Ligação termina

    Ao desligar, ficam a gravação, a transcrição fala a fala e um resumo.

  6. 6

    Resultado no webhook

    Um POST na sua URL com o resultado inteiro, pronto para gravar no seu sistema.

O pedido

Um JSON e nada mais

Com um agente criado no painel, o pedido tem três campos. As variáveis entram no roteiro onde você escreveu {{primeiro_nome}}.

  • Sem agente, mande prompt, modo e voz no próprio pedido.
  • A resposta vem com o id e o seu saldo depois da reserva.

curl

curl -X POST "https://api.respondendo.app/v1/ligacoes" \
  -H "Authorization: Bearer rsp_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "telefone": "5511988888888",
    "agente_id": 12,
    "variaveis": {
      "primeiro_nome": "Antônio",
      "visita": "quinta às 15h"
    }
  }'

// 202
{ "id": 512, "status": "em_andamento", "saldo": 93.470 }

Exemplos

O que dá para fazer com uma ligação

Quatro usos comuns. Em todos, o pedido é o mesmo: muda o roteiro do agente, as variáveis e as ferramentas.

Confirmação de visita

A IA liga um dia antes, confirma o horário e, se a pessoa não puder, oferece outro horário livre da sua agenda.

Variáveis
primeiro_nome, visita
Ferramenta
consultar_horarios
No resultado
Confirmou, remarcou ou cancelou, com o novo horário no resumo.

Lembrete de vencimento

Avisa do vencimento com educação, tira dúvida sobre valor e data e, se a pessoa pedir, manda a segunda via.

Variáveis
primeiro_nome, valor, vencimento
Ferramenta
segunda_via
No resultado
A data em que a pessoa disse que vai pagar.

Pesquisa de satisfação

Liga depois do atendimento, faz duas ou três perguntas curtas e grava a nota no seu sistema durante a conversa.

Variáveis
primeiro_nome, atendimento
Ferramenta
registrar_nota
No resultado
A nota de 0 a 10 e o comentário da pessoa.

Retorno a quem pediu contato

Liga em minutos para quem preencheu o formulário do seu site, entende o interesse e passa o contato para o vendedor.

Variáveis
primeiro_nome, interesse
Ferramenta
registrar_interesse
No resultado
O interesse, o orçamento e o melhor horário para o vendedor ligar.

Na prática

O que acontece em cada caso

Nem toda ligação é atendida. Cada situação tem o seu registro, no painel e no resultado.

Ninguém atendeu
A ligação termina como não atendida e o resultado chega com atendida: false.
Caiu na caixa postal
A ligação é marcada como caixa postal e o resultado chega com caixa_postal: true.
Ocupado ou número errado
O histórico do painel mostra a situação: ocupado, recusada, número inexistente ou erro da operadora.
Várias ao mesmo tempo
Cada POST é uma ligação, e elas correm em paralelo até o limite de canais da sua conta. A resposta do POST traz canais_permitidos e em_andamento.
Mudou de ideia
DELETE /v1/ligacoes/{id} tira a ligação da fila ou encerra a que está em andamento.
Fora do horário
Listas enviadas pelo painel respeitam o horário de ligação que você define: fora dele, param e continuam no dia seguinte.