| Data de elaboração: | 31/07/2025 |
| Responsável pelo estudo: | Henrique Gomes Teixeira (Analista) |
| Alvo: | Portal do Cidadão |
| Origem: | Integração com os serviços de IA fornecidos pela CAGD. |
| Objetivo: | Este estudo técnico tem como finalidade orientar a integração do chatbot Clara, uma ferramenta de atendimento automatizado baseada em inteligência artificial, ao Portal do Cidadão, garantindo uma implementação eficiente, acessível e alinhada às melhores práticas de UX, segurança e interoperabilidade. |
O chatbot Clara é um agente de atendimento digital baseado em IA, desenvolvido e mantido pela CAGD, que será incorporado ao Portal do Cidadão por meio de um botão flutuante com canal de comunicação via WebSocket.
Toda a lógica da IA, conteúdo das respostas e manutenção da API WebSocket são de responsabilidade exclusiva da CAGD. A equipe da GDEV será responsável apenas pela ativação e visibilidade do chatbot no portal, através da inclusão do script no layout HTMLCS, garantindo sua presença em todas as páginas.
A integração contempla:
| Tecnologia | Descrição |
|---|---|
| Rasa WebChat | Componente visual do chatbot (interface conversacional) |
| WebSocket | Canal de comunicação em tempo real com o backend da IA |
| HTML/JS | Código de integração direto no Portal do Cidadão |
| CDN (jsDelivr) | Fonte para carregamento do script do WebChat |
O código de integração foi fornecido pela CAGD, cabendo à GDEV apenas sua inclusão visual no layout do Portal do Cidadão.
O seguinte trecho de código JavaScript deve ser incluído no layout HTML principal (HTMLCS) do portal:
<script>
(function () {
const webchatConfig = {
initPayload: '/cumprimentar',
customData: { language: "pt" },
socketUrl: "https://chatbot.cagd.gov.br/", // Substituir pela URL oficial da CAGD
title: 'Clara',
inputTextFieldHint: "Como posso ajudar?",
profileAvatar: "clara-avatar.png",
showMessageDate: true,
userBackgroundColor: "#006699",
userTextColor: "#ffffff",
mainColor: "#005288"
};
const script = document.createElement("script");
script.src = "https://cdn.jsdelivr.net/npm/rasa-webchat@1.x.x/lib/index.js";
script.async = true;
script.onload = () => {
window.WebChat.default(webchatConfig, null);
};
script.onerror = () => {
console.error('Erro ao carregar o componente do chatbot Clara');
};
document.head.insertBefore(script, document.head.firstChild);
localStorage.clear();
})();
</script>
A URL do
WebSockete o caminho doavatardevem ser fornecidos oficialmente pela CAGD antes da publicação.
| Entidade | Responsabilidade |
|---|---|
| CAGD | Fornecer WebSocket, lógica da IA, payloads e suporte técnico do chatbot |
| GDEV | Inserção do script no layout HTMLCS, controle de visibilidade e responsividade |
| Etapa | Responsável | Observações |
|---|---|---|
| Fornecimento da URL WebSocket | CAGD | Produção e homologação |
| Inclusão do script no portal | GDEV | Inserção no layout HTMLCS |
| Testes funcionais | Conjunto | Verificar comunicação com IA |
| Liberação em produção | GDEV | Após validações com a equipe da CAGD |
A integração do chatbot Clara ao Portal do Cidadão representa um passo importante para modernizar o atendimento digital oferecido ao cidadão, com foco em praticidade, escalabilidade e inovação. A responsabilidade pela lógica, infraestrutura e treinamentos da IA é da CAGD, enquanto a equipe GDEV assegura a presença técnica e visual do componente em todas as páginas do portal.
Cabe ressaltar que, no momento da elaboração deste estudo, não foi possível realizar testes práticos de integração com o WebSocket, uma vez que o ambiente do chatbot ainda não estava disponível para homologação por parte da CAGD. Assim que o canal estiver acessível, novos testes deverão ser conduzidos para validar a comunicação e o comportamento do componente no Portal.