O Test do Adalo envia mensagens de verdade: antes de ligar notificações ao trabalho diário

Ao conectar uma API de notificações com o Ada do Adalo, defina primeiro o destino de teste, as variáveis de exemplo e os resultados esperados. O Test em Custom Actions executa requisições reais; mesmo com a prévia funcionando, confira o recebimento externo antes de incorporar a ação ao fluxo real.

Fonte: ada-help.adalo.com
November 7, 2026
5 min

Adicionar um botão “Notificar responsável” a um aplicativo interno de solicitações parece apenas mais uma operação. Mas a entrega exige uma cadeia completa: o que o usuário envia, para onde a mensagem vai, qual resposta chega e como a interface explica uma falha. O Ada do Adalo pode alterar aplicativos por meio de linguagem natural e conectar APIs externas com Custom Actions. A documentação oficial, porém, deixa claro que o Test no editor de ações faz requisições reais.

Por isso, na primeira integração de notificações, prepare um destino exclusivo para testes antes de pedir ao Ada que o conecte à interface. A análise a seguir usa como cenário o envio de uma notificação após uma solicitação. A sequência de verificação foi elaborada com base na documentação oficial do novo Ada; nenhum aplicativo foi executado nem mensagem enviada para este artigo.

Inclua o destino nos requisitos, não apenas “adicione um botão”

Limite primeiro o escopo a uma ação completa: no aplicativo de teste, o usuário digita uma solicitação fictícia, clica no botão e envia o texto e o identificador do registro de teste ao destino definido; depois, a interface mostra sucesso ou falha. Não acrescente aprovação, pagamento e exclusão de registros ao mesmo tempo nessa primeira tentativa. O guia de construção do Ada recomenda começar com uma mudança coerente, para facilitar a identificação de alterações na navegação ou no comportamento dos dados existentes.

Ao nomear a ação, explique também quando ela deve ser acionada e para que serve. Por exemplo, “Notificar o canal de teste sobre a solicitação de teste atual” é mais fácil de conferir do que “Processar solicitação”. A documentação oficial de Custom Actions informa que o Ada lê a descrição da ação para decidir quando e como chamá-la. Uma descrição vaga pode ligar a ação ao lugar errado da interface, mesmo que a conexão com a API funcione.

O canal de teste é apenas uma escolha deste cenário: nem todos os serviços oferecem um ambiente isolado de testes. Se o serviço receptor não tiver esse ambiente, prepare um destino de teste autorizado que não incomode clientes reais. Se isso não for possível, mantenha o rascunho da interface sem conectar as notificações reais.

Valores de exemplo também são entradas de uma operação real

Preencha o método, o endereço e as variáveis necessárias de acordo com a documentação da API receptora. Confira se todos os valores de exemplo são fictícios. Verifique especialmente o canal, o e-mail ou o identificador do registro de destino: estar na área de “exemplo” não significa que esses valores não serão usados.

A documentação do Ada explica que o Test executa a requisição com esses valores e, quando ela funciona, guarda uma amostra da resposta para ajudar a conectar os campos retornados à interface. Não é um botão que apenas verifica a formatação. Antes do teste, registre qual mensagem deve aparecer em qual destino e o que o aplicativo deve mostrar. Depois, confira tanto o resultado externo quanto o da interface. Uma resposta de sucesso da API não basta se a notificação chegar ao lugar errado.

As chaves devem ficar na configuração específica de Secrets, não em prompts, campos de entrada comuns ou mensagens de exemplo. Segundo a documentação oficial, elas são armazenadas de forma criptografada no servidor, inseridas durante a chamada e não são distribuídas com o aplicativo. Esse mecanismo não decide quais dados do negócio podem ser enviados a um serviço externo: os campos transmitidos ainda precisam ser selecionados um a um.

Percorra todo o caminho do botão

Depois de aprovar o teste da ação, percorra a prévia desde a entrada na página de solicitação, em vez de apenas clicar no novo botão. Verifique também se as mensagens são compreensíveis com entrada vazia, durante o carregamento e em falhas da API. O guia oficial de prévia orienta a conferir o percurso completo do usuário e esses estados; ele não garante que a interface gerada já trate corretamente todas as situações.

Você pode usar três perguntas para validar essa cadeia de notificações: a mensagem de sucesso corresponde ao recebimento real no destino? Em caso de falha, a interface ainda informa incorretamente que houve envio? Cliques repetidos geram notificações duplicadas que a equipe não pode aceitar? Se o envio repetido tiver consequências para o negócio, peça à pessoa responsável pela API que confirme a estratégia para evitar duplicações. Não presuma que o Ada ou o serviço receptor já resolva isso automaticamente.

Após cada alteração, dê à versão um nome identificável, como “Cadeia de notificação de teste conferida”. A documentação do Ada informa que mudanças concluídas podem ser salvas em versões que podem receber nomes e ser restauradas. Restaurar uma versão do aplicativo não deve ser tratado como uma forma de retirar mensagens já enviadas para fora dele: depois que a notificação sai, seu tratamento depende dos mecanismos do destinatário.

Por fim, separe a validação na prévia da validação em produção. O ambiente real pode usar destinos, chaves e permissões diferentes. Após a mudança, confira novamente toda a cadeia com conteúdo de teste autorizado. O Adalo também orienta a testar separadamente a experiência publicada. O botão só deve ser entregue a usuários reais do negócio quando o retorno da interface corresponder à ação externa.

Nota sobre o conteúdo:Este artigo foi elaborado com base em informações públicas e serve como referência para a escolha de ferramentas. Os recursos, os preços e as políticas relacionadas podem mudar a qualquer momento; consulte as informações oficiais mais recentes.

Fonte original:ada-help.adalo.com