Back-end para integrar IA (Claude/GPT/Gemini) ao atendimento

Requisitos

• Desenvolvedor back-end para integrar IA (Claude/GPT/Gemini) ao atendimento via WhatsApp de um ERP/CRM
• Tenho um ERP/CRM com módulo de conversas online que hoje atende apenas WhatsApp
• Um servidor separado faz a ponte entre o ERP e as redes sociais: recebe webhooks, armazena contatos e envia respostas
• A ideia é que várias empresas atendam todos os clientes de um só lugar, cada uma com seu número
• Preciso implementar nesse servidor-ponte a execução e a administração de agentes de IA que respondam clientes automaticamente
• A IA deverá responder dúvidas sobre determinada empresa, consultar status de pedido, gerar cotação e enviar boletos em aberto, sempre chamando o ERP por uma API
• No futuro, poderá gerar formas de pagamento
• O servidor-ponte e o módulo de conversas já funcionam com WhatsApp
• A modelagem de dados ainda será analisada e desenhada, incluindo agentes, modelos, ferramentas, conversas, execuções, conhecimento por empresa, limites e uso
• O profissional escolhido poderá sugerir melhorias
• Requisitos principais - Camada de abstração de provedores, com pelo menos Anthropic e OpenAI no início e Gemini como opcional, troca por configuração e fallback automático. - Montagem de contexto a cada chamada, incluindo instruções do agente, conhecimento da empresa, ferramentas liberadas, resumo e últimas mensagens, com prompt caching. - Tool calling com ferramentas cadastradas em banco, retorno padronizado e confirmação explícita do cliente para ações financeiras. - Multiempresa e multifilial
• O servidor injeta empresa e cliente no contexto, e o ERP resolve a filial
• a IA nunca escolhe esses dados. - Estados de conversa: IA ativa, aguardando cliente, aguardando humano e humano
• Transferência para atendente, sem resposta da IA durante o atendimento humano. - Registro de tokens, custo, latência, versão do prompt, chamadas de ferramenta, argumentos, resultados e limites por empresa. - Segurança contra prompt injection, chaves criptografadas, logs sem dados sensíveis e atenção à LGPD. - Testes e documentação da API, do fluxo e da implantação
• Fora do escopo: telas no ERP, RAG com embedding e outras redes sociais
• A arquitetura deve permitir futuras extensões
• Entregas sugeridas: - Revisão do modelo de dados, scripts SQL de criação e migração e documento de arquitetura. - Camada de provedores, montagem de contexto e resposta automática com conhecimento fixo, sem ferramentas. - Motor de ferramentas e integração com a API do ERP. - Controle de conversa, transferência para humano, limites de uso, auditoria e painel básico de consumo. - Testes, ajustes, documentação final e acompanhamento em produção por alguns dias
• Aceito propostas por fase ou pelo projeto completo
• Tecnologias: servidor-ponte atual com Debian, PHP e MariaDB
• banco MySQL 8
• API HTTP/REST para integração com o ERP
• APIs Anthropic, OpenAI e, opcionalmente, Google Gemini
• Perfil desejado: experiência comprovada com APIs de LLM e tool calling em produção, back-end, MySQL, modelagem de dados, webhooks, filas ou processamento assíncrono
• Experiência com WhatsApp é um diferencial
• É necessário cuidado com segurança, arquitetura multiempresa, comunicação e documentação clara