Produtos e disponibilidade
Forneça características, preços e disponibilidade para apoiar perguntas sobre seu catálogo.
Conector externo via API
Conecte os dados do seu sistema ao agente de IA no WhatsApp.
Permita que o agente consulte pedidos, produtos, cadastros e configurações durante a conversa. Sua API fornece os dados; o Whatsplaid usa as informações relevantes para ajudar o cliente.
Fonte de conhecimento
Assistente no WhatsApp
Da pergunta à resposta
01
O cliente faz uma perguntaO agente identifica quando os dados do sistema são necessários.
02
O agente coleta o identificadorE-mail, celular ou código, conforme sua configuração.
03
Sua API retorna os dadosO sistema conectado determina quais informações podem ser acessadas.
04
A conversa continua com contextoO agente usa os dados relevantes para formular a resposta.
Uma fonte de conhecimento com os dados que sua operação precisa.
O conector pode receber objetos ou listas JSON com diferentes estruturas. Você decide o que disponibilizar na API e em quais situações o agente deve consultar, sem limitar a integração a um único tipo de informação.
Pedidos e entregas
Retorne o andamento do pedido, itens e informações de entrega autorizadas para o cliente.
Dados cadastrais
Disponibilize informações relevantes do cadastro para contextualizar o atendimento.
Configurações da conta
Ajude o agente a entender o cenário do cliente com dados de configuração, consumo ou limites retornados pelo seu software.
Configure a conexão e defina quando ela entra na conversa.
A configuração técnica fica em Desenvolvedores. Depois de testar e ativar o conector, escolha a API como fonte de conhecimento nas configurações do agente de IA.
01Conecte sua API
Em Desenvolvedores, abra Conectores externos e selecione Base de conhecimento via API. Informe a URL base HTTPS e o token Bearer, quando necessário.
02Defina o identificador e teste
Configure o endpoint, o identificador de consulta e o nome do parâmetro esperado pela API. Teste com um registro existente antes de prosseguir.
03Oriente o acionamento
Na etapa de ativação, descreva quando o conector deve ser acionado na conversa. Por exemplo: consulte os dados da conta quando o cliente relatar um problema técnico e peça o e-mail cadastrado se ele ainda não estiver disponível.
04Selecione a fonte no agente
Ative e salve o conector. Em Agente de IA, abra Base de Conhecimento, selecione Conector externo via API, habilite seu uso e salve as alterações.
05Valide o atendimento
Teste conversas com e sem o identificador, confira as respostas e acompanhe as chamadas em Atividade recente. Ajuste as orientações à finalidade da sua API.
Sua API controla os dados. O agente mantém a conversa.
A consulta acontece quando o contexto e as orientações configuradas pedem informações da fonte externa. Perguntas gerais e saudações continuam seguindo o atendimento do agente.
Autorização no seu sistemaO identificador informado não comprova a identidade do cliente. Sua API deve aplicar as regras de acesso e retornar somente dados autorizados.
Consulta no momento do atendimentoA API retorna as informações disponíveis no seu sistema naquele momento. A atualização e a disponibilidade desses dados dependem da fonte conectada.
Uma fonte escolhida por agenteAo selecionar API, este agente usa o conector externo como base de conhecimento. Arquivos e Google Sheets deixam de ser consultados por ele.
O que saber antes de conectar sua API.
Preciso preparar uma API?
Sim. Seu sistema precisa oferecer um endpoint HTTPS público que receba o identificador configurado e retorne um objeto ou lista JSON com dados. A equipe responsável pelo sistema prepara a integração e suas regras de acesso.
Posso retornar diferentes tipos de informação?
Sim. A resposta pode reunir diferentes dados autorizados em uma mesma estrutura JSON. Cada agente usa um conector; você pode ampliar os dados retornados pela API do seu sistema.
O agente consulta em toda mensagem?
Não. Ele considera o contexto da conversa e a orientação definida em Quando o conector deve ser acionado na conversa. Se precisar do identificador e ele ainda não estiver disponível, solicita essa informação ao cliente.
O conector altera dados no meu sistema?
Este recurso realiza consultas GET para buscar informações. Não é um mecanismo para cadastrar, atualizar ou excluir registros no sistema conectado.
Qual é a diferença para a API pública do Whatsplaid?
No conector externo, o Whatsplaid consulta sua API para apoiar o atendimento. Na API pública, seu sistema chama o Whatsplaid para operar recursos da plataforma. Conheça a API pública e os webhooks.
Traga os dados do seu sistema para a conversa.
Escolha a fonte de conhecimento que combina com sua operação: API externa, planilhas ou documentos. Google Sheets · Importação de documentos