Vínculos de reações

As reações raramente funcionam sozinhas — elas se invocam mutuamente por botões, cadeias, ramificação "caso contrário", respostas em diálogo e assim por diante. Os vínculos de reações mostram esse grafo de transições: para qualquer reação é possível ver para onde ela leva (vínculos de saída) e de onde ela é acessada (vínculos de entrada). Isso ajuda a não se perder em cenários grandes e a excluir reações com segurança.

O que é um vínculo

Um vínculo é uma transição direcional de uma reação para outra, marcada com o mecanismo que gerou essa transição. A plataforma percorre a reação completamente e coleta todas as transições de saída, descartando referências a si mesma e alvos vazios, e mescla transições idênticas. A lista de vínculos está disponível no editor de reação e via API: GET /api/bots/{id}/reactions/{id}/links.

Vínculos de entrada e saída

  • Saída — para quais reações a atual faz referência (seus botões, cadeias, ramificação "caso contrário" etc.).
  • Entrada — quais reações fazem referência à atual. Útil antes de excluir: se alguma reação aponta para a atual, a exclusão quebrará o cenário.

12 mecanismos de vínculo

  • Botão (button) — botão inline do tipo "Invocar reação" abre outra reação ao clicar.
  • Substituição por botão (button_replace) — botão com comportamento "substituir mensagem" insere o conteúdo da reação vinculada.
  • Botão dinâmico (dynamic_button) — botão do bloco "Botões dinâmicos a partir de lista" leva a uma reação. Veja Botões dinâmicos e parâmetros.
  • Bloco "Reação" (block) — bloco de mensagem que invoca outra reação durante o envio.
  • Reação em cadeia (chain) — ação "Reação em cadeia" inicia outra reação.
  • Ramificação "caso contrário" (else) — se as condições não forem atendidas, o controle vai para a reação especificada.
  • Requisição web: sucesso (web_success) — reação iniciada em caso de requisição web bem-sucedida.
  • Requisição web: erro (web_error) — reação iniciada em caso de erro na requisição web.
  • Resposta esperada (expected_answer) — reação acionada pela resposta do usuário em uma etapa de diálogo.
  • Timeout de espera (expected_timeout) — reação acionada se nenhuma resposta chegou antes do timeout.
  • Próxima reação (goto_next) — ação "Próxima reação" passa o controle para a próxima reação adequada na lista.
  • Cenário (flow) — reação vinculada à conclusão de um cenário (flow).

Por que visualizar o grafo

  • Navegação pelo cenário — navegar rapidamente para a reação vinculada sem precisar buscá-la na lista.
  • Exclusão segura — ver os vínculos de entrada e não quebrar transições.
  • Auditoria — verificar que todas as ramificações do cenário levam ao destino correto e não há transições "soltas".

Próximos passos