Skip to main content
Resposta

Documentação de arquitetura/estrutura chatbot

  • October 21, 2025
  • 2 comentários
  • 45 Visualizações

Marcelo Carveche

Olá, pessoal. Tudo bom?

Existe alguma documentação sobre boas práticas, arquitetura, estrutura do bot etc?

Gostaria de planejar e implantar uma nova estrutura no meu bot mas não quero inventar a roda. Se existir alguma documentação para seguir boas práticas ajudaria muito. 

Quero uma estrutura que atenda a esses requisitos mínimos:

  • Observabilidade: Gostaria de trackear toda a jornada de um contato e armazenar por atendimento, podendo assim consultar todos os blocos que o contato passou e as variáveis do contexto daquele atendimento específico.
  • Manutenibilidade: Gostaria de componentizar alguns fluxos e começar a utilizar funções globais, pois existem blocos repetidos e muitos scripts repetidos, dificultando a manutenção quando preciso corrigir algo.
  • Escalabilidade: No geral, meu fluxo esta razoavelmente grande e vai crescer ainda mais, no entanto, não me sinto seguro com a estrutura atual.

Melhor resposta por Lucas Ventura

@Marcelo Carveche bom dia!

Complementando os links que o Rafael enviou acima, eu recomendo vc a separar em vários subbots (quase sempre que for um fluxo repetido eu crio um subbot pra facilitar a manutenção) e também eu tenho um bot “Apis” pra realizar todas requisições Http. Com isso, se alguma API que eu use em vários lugares sofrer alterações, eu preciso mudar somente em 1 lugar (dentro do subbot Apis) e nao preciso ficar procurando e corrigindo todos lugares que usam essa rota.

Outra dica é sempre que tem redirecionamento entre bots, sempre passe um json, pois vc consegue passar várias informações (no caso do api por exemplo: status, body)

2 comentários

Rafael_Figueiredo
Blipper
Forum|alt.badge.img+6

Olá, pessoal. Tudo bom?

Existe alguma documentação sobre boas práticas, arquitetura, estrutura do bot etc?

Gostaria de planejar e implantar uma nova estrutura no meu bot mas não quero inventar a roda. Se existir alguma documentação para seguir boas práticas ajudaria muito. 

Quero uma estrutura que atenda a esses requisitos mínimos:

  • Observabilidade: Gostaria de trackear toda a jornada de um contato e armazenar por atendimento, podendo assim consultar todos os blocos que o contato passou e as variáveis do contexto daquele atendimento específico.
  • Manutenibilidade: Gostaria de componentizar alguns fluxos e começar a utilizar funções globais, pois existem blocos repetidos e muitos scripts repetidos, dificultando a manutenção quando preciso corrigir algo.
  • Escalabilidade: No geral, meu fluxo esta razoavelmente grande e vai crescer ainda mais, no entanto, não me sinto seguro com a estrutura atual.

Olá ​@Marcelo Carveche tudo bem ?

Poderia dar uma olhada em : 

https://www.blip.ai/blog/chatbots/como-criar-um-chatbot/

https://www.blip.ai/blog/chatbots/design-de-conversas-do-chatbot/

 


Lucas Ventura
Forum|alt.badge.img+3
  • Specialist
  • Resposta
  • October 24, 2025

@Marcelo Carveche bom dia!

Complementando os links que o Rafael enviou acima, eu recomendo vc a separar em vários subbots (quase sempre que for um fluxo repetido eu crio um subbot pra facilitar a manutenção) e também eu tenho um bot “Apis” pra realizar todas requisições Http. Com isso, se alguma API que eu use em vários lugares sofrer alterações, eu preciso mudar somente em 1 lugar (dentro do subbot Apis) e nao preciso ficar procurando e corrigindo todos lugares que usam essa rota.

Outra dica é sempre que tem redirecionamento entre bots, sempre passe um json, pois vc consegue passar várias informações (no caso do api por exemplo: status, body)