Resumo
Um assistente telefónico com IA só consegue gerir marcações e dados de clientes de forma fiável se comunicar com o sistema de referência da empresa. Webhooks e APIs permitem consultar informação durante uma chamada e guardar resultados confirmados. Este guia explica o fluxo habitual, os casos de erro e as medidas de proteção, desde a consulta de disponibilidade até à nota no CRM.
O sistema ligado tem de ser a fonte de verdade
Um modelo de linguagem pode compreender uma data e fazer perguntas relevantes. Não deve decidir por si se há uma vaga disponível ou se um registo foi alterado. Essa informação tem de vir do calendário, CRM ou sistema de gestão de trabalhos.
Um processo seguro funciona assim: o assistente identifica a ação pretendida; recolhe e confirma os dados necessários; uma integração consulta o sistema de destino; o sistema devolve opções disponíveis ou um erro; o assistente comunica apenas resultados confirmados; após a concordância de quem liga, é enviada a marcação ou alteração; por fim, o sistema confirma novamente o resultado.
Se não existir uma integração adequada, o assistente pode registar o pedido de forma estruturada e enviá-lo à equipa, em vez de fingir que fez uma marcação.
APIs e webhooks: qual é a diferença?
Uma API disponibiliza dados ou funções definidos através de endpoints técnicos. Um webhook é frequentemente um pedido específico enviado a um desses endpoints durante um processo. Por exemplo, um assistente pode consultar horários livres ou enviar ao CRM os contactos confirmados e o motivo da chamada.
Com os nossos webhooks, os assistentes da VoiceBooker podem consultar informação atualizada de sistemas externos durante a chamada ou enviar-lhes dados confirmados. As ações possíveis também dependem das interfaces e permissões do sistema ligado.
Nos fluxos com várias etapas, pode manter os dados confirmados disponíveis durante a conversa no objeto State e enviá-los depois para um webhook. Assim, o assistente não precisa de voltar a perguntar o nome, o motivo ou a opção escolhida. Guarde e transfira apenas os valores necessários para a etapa seguinte.
Exemplo: marcar um horário por telefone
Imagine um serviço de marcações que precisa do tipo de serviço, local, período pretendido e contactos. O assistente deve recolher os dados passo a passo e pedir especificamente a informação em falta.
Verificar disponibilidade
O assistente envia os critérios necessários ao calendário, que devolve os horários disponíveis. Só apresenta essas opções e deixa a pessoa escolher. Se não houver um horário adequado, pode perguntar por outro período ou registar um pedido de retorno.
Confirmar a marcação
Depois de escolhido o horário, o sistema envia o pedido de marcação. Só uma resposta positiva do calendário permite ao assistente confirmar a marcação. Se o calendário indicar um conflito ou estiver indisponível, não deve dizer que a marcação foi concluída.
Atualizar o CRM
Após uma marcação bem-sucedida, uma nota no CRM pode conter o horário, o motivo da chamada e os contactos necessários. Transfira apenas os dados úteis para o passo seguinte. Uma gravação completa não é automaticamente necessária.
Proteções técnicas e gestão de erros
Evitar ações duplicadas
Após um tempo de espera excedido, pode não ser claro se o pedido chegou ao sistema. Uma nova tentativa não deve marcar o mesmo horário duas vezes sem aviso. Se o sistema permitir, use um identificador único e verifique o estado atual da marcação.
Validar os dados
Antes de enviar, valide o formato da data, o número de telefone, os campos obrigatórios, os serviços permitidos e o local. Peça confirmação dos dados importantes em vez de os adivinhar a partir de uma fala pouco clara.
Tratar erros com clareza
Defina o que fazer se a integração estiver indisponível, os dados forem inválidos ou não houver resposta. As alternativas podem ser um pedido de retorno, uma notificação interna ou uma transferência para a equipa. O assistente deve explicar a limitação de forma simples e nunca afirmar que uma ação foi concluída sem confirmação.
Minimizar credenciais e dados
As integrações exigem autenticação. Guarde as credenciais em segurança, limite as permissões às ações necessárias e não inclua segredos como tokens de API nos dados da conversa. Transfira apenas a informação necessária para cada tarefa.
Testar antes do lançamento
Além dos pedidos bem-sucedidos, teste datas inválidas ou incompletas; um horário ocupado instantes antes da marcação; chamadas duplicadas e novas tentativas da API; identificação incorreta do cliente; respostas vazias, tempos excedidos e erros do servidor; alterações ou cancelamentos rejeitados pelo sistema; e mensagens para marcações bem-sucedidas e falhadas.
Compare o registo da conversa com o sistema de destino. Os horários, nomes e ações coincidem? A equipa consegue perceber depois o que aconteceu?
Conclusão
Ligar o CRM ou o calendário permite ao assistente executar ações, mas também torna essencial que as atualizações sejam corretas. O sistema tem de confirmar disponibilidades e alterações concluídas; depois, o assistente comunica o resultado com clareza. Percursos para falhas, credenciais seguras e testes realistas devem fazer parte da integração desde o início.
Consulte também os nossos guias de webhooks e acesso à API.