API, webhook e integração: o que seu fornecedor precisa que você tenha

Em quase todo projeto de agente de IA, existe uma pergunta que decide metade do cronograma: "o seu sistema tem API?". Quem responde "não sei" costuma descobrir o resto do projeto na marra.

API: o agente perguntando

Pense numa porta de atendimento que um sistema abre para outros sistemas. Quando o agente precisa saber algo que está no seu ERP — tem esse produto? qual o saldo desse cliente? esse horário está livre? — ele bate nessa porta e recebe a resposta.

Sem essa porta, o agente só sabe o que foi escrito antes em documento. E documento envelhece: preço muda, produto acaba, agenda enche.

Webhook: o sistema avisando

O caminho inverso, e o mais subestimado. Em vez de o agente perguntar de tempos em tempos, o seu sistema avisa quando algo acontece:

• Pedido faturado.
• Ordem de serviço concluída.
• Pagamento confirmado.
• Entrega saiu.

É o que permite o agente informar o cliente antes de ele perguntar — que é a diferença entre atendimento reativo e proativo.

Cliente informado não pergunta. A maior parte do volume de "e aí, como está?" é ausência de webhook.Padrão em suporte e ordem de serviço

O que precisa de integração e o que não precisa

Vive bem em base de conhecimento

• Horário, endereço, formas de pagamento.
• Política de troca, cancelamento e garantia.
• Descrição de produtos e serviços.
• Perguntas frequentes.

Exige integração

• Estoque e disponibilidade.
• Agenda e horários livres.
• Situação financeira do cliente.
• Status de pedido, serviço ou processo.
• Histórico de compra.

Automatizar o segundo grupo sem integração produz informação errada com cara de certeza — o pior resultado possível.

Quando não existe API

É comum em sistemas antigos e em softwares de nicho. Três alternativas, em ordem de robustez:

• Exportação periódica. O sistema gera um arquivo com catálogo e preço a cada X horas. Funciona bem para dado que muda pouco; ruim para estoque em tempo real.
• Banco intermediário. O sistema alimenta uma base separada que o agente consulta. Mais fresco, exige alguém do lado do sistema para manter.
• Automação de interface. Um robô simula um usuário navegando no sistema. Funciona, mas quebra a cada atualização de tela.

Todas funcionam. Todas são mais frágeis e mais caras de manter do que uma API.

As quatro perguntas para o seu fornecedor

• Existe API documentada?
• Existe ambiente de teste separado da produção?
• Há custo adicional para liberar o acesso?
• Qual o prazo de liberação?

Faça essas perguntas antes de contratar o projeto de IA. Elas costumam ser a maior fonte de atraso, como detalhamos em quanto tempo leva para implantar.

Segurança e acesso

Integração significa dar a um sistema externo acesso aos seus dados. Vale exigir:

• Credencial específica para a integração, não a de um usuário administrador.
• Permissão mínima — só o que o agente precisa consultar.
• Registro de acessos.
• Possibilidade de revogar sem derrubar outras coisas.

Não sabe se o seu sistema tem API?

A Fluxo Inteligente faz o levantamento com o seu fornecedor antes de fechar escopo — e propõe alternativa quando não houver.