Arquitetura de Integração entre WhatsApp e Blockchain
Ir para notas que citam estaArquitetura de integração entre WhatsApp e blockchain é o arranjo de componentes que leva uma resposta digitada numa conversa até uma transação confirmada na cadeia e a devolve como resultado consultável.
O arranjo existe porque os dois extremos não se falam: quem responde pelo celular não assina transação nem guarda chave, e a cadeia só entende chamadas de método de um contrato. No produto de pesquisas da bancada, o desenho resolve isso com cinco peças, cada uma com uma responsabilidade que as outras não assumem: canal de conversa, camada de serviço, contrato, job de leitura e base de consulta. Os dois atores do produto, o pesquisador que cria a pesquisa e o respondente que a responde, usam o mesmo canal.
O caminho de ida, da conversa ao contrato
A conversa acontece no WhatsApp, montada sobre a plataforma Blip, que conduz o diálogo e repassa cada escolha do usuário ao backend. Isolar o canal nessa ponta permite trocar ou somar aplicativos de mensagem sem mexer nas camadas de baixo.
Abaixo do canal fica a camada de serviço, desenhada como um Backend for Frontend. Ela gerencia as carteiras intermediárias que efetivamente escrevem na cadeia em nome de quem conversa e traduz cada interação no método correspondente do contrato. É também um espelho do que o contrato registra: usuários, pesquisas, questões e opções ficam guardados num banco relacional próprio do serviço, organizado como um monólito com uma tabela por entidade.
Na base, o Contrato Inteligente de Pesquisas guarda as regras: quem pode responder, quando a pesquisa encerra e como o resultado é apurado. Ele roda numa rede privada em Hyperledger Besu, onde as transações não têm custo real de gas.
Por que a pesquisa é criada numa única operação atômica
O contrato exige que pesquisa, perguntas e opções de resposta cheguem juntas, num só envio; não existe acrescentar perguntas depois.
Por isso a camada de serviço não oferece um CRUD completo e separado para pesquisa, pergunta e opção. Um único ponto de entrada recebe a pesquisa inteira, e o serviço de pesquisas gerencia internamente questões e opções dentro de uma transação de banco, sem que o controlador de pesquisas chame controladores de outras entidades. Se algo falha no meio da gravação, nada fica registrado, e nunca surge uma pesquisa sem perguntas.
Endpoints separados abririam a porta para salvar rascunho, retomar uma pesquisa incompleta ou montar várias em paralelo. Cada uma traz fluxos alternativos e complexidade de que uma primeira versão não precisa; a escolha simplifica e deixa essas jornadas como evolução possível.
O formato da pesquisa pesa tanto quanto a atomicidade. A definição de que as perguntas são objetivas, em número limitado e com opções pré-definidas (pelo menos duas por questão) mudou o modelo de dados do backend e a estrutura do contrato ao mesmo tempo. Requisitos e contrato precisam andar juntos, porque o contrato reflete exatamente o formato decidido.
O caminho de volta, da cadeia à base de consulta
Consultar a blockchain diretamente é caro: reconstruir o histórico de uma transação exige percorrer a cadeia do primeiro ao último bloco. Na rede da moeda Sol Digital, que já contava cerca de 4 milhões de blocos quando esse desenho foi definido, um select direto na cadeia ficaria lento demais.
O Transaction Consumer cobre essa volta. É um job em Java que espelha todas as transações da rede num banco relacional PostgreSQL e decodifica as que pertencem ao contrato de pesquisas, transformando o input bruto em dados estruturados. Resultados e análises saem dessa base, e a cadeia continua sendo a fonte da verdade.
Uma base reaproveitada, uma frente nova
A parte de baixo do desenho repete a do produto anterior da bancada, a Sol Digital, onde rede, carteiras, backend e job de espelhamento já rodavam. O que muda é a frente, que deixa de ser uma interface própria e vira conversa. O time se divide pelas mesmas peças: análise funcional e fluxos conversacionais no canal, backend entre camada de serviço e job de leitura, e um perfil web3 no contrato.