Pesquisas — gatilhos: enviar a pesquisa sozinho quando a situação muda

O QUE É
O gatilho envia uma pesquisa por e-mail sozinho quando um orçamento, venda, OS ou pedido de e-commerce é salvo com a situação escolhida no gatilho. Não existe gatilho genérico "de venda": ele vale para UMA situação específica. Por isso pergunte ao cliente qual situação ele escolheu, não qual módulo.

COMO MONTAR - QUASE TUDO JÁ VEM DEFINIDO
Nome: escreva um nome. Todos os campos do formulário são obrigatórios; se não salvar, procure o campo marcado em vermelho. Pela API, sem nome o retorno é "Preencha os campos obrigatórios.".
Quando: vem preenchido com "Ao alterar" e travado, não dá para trocar. Não está faltando opção.
Atributo: vem preenchido com "Situação" e travado, também não dá para trocar.
Para: a situação, num select agrupado por Ordens de serviços, Vendas e Orçamentos; o grupo E-commerce só aparece quando a empresa tem situações de pedido cadastradas.
Então deverá: a única ação disponível é "Enviar pesquisa".
Pesquisa: campo de busca por nome. Só lista pesquisa com situação Ativa, que não seja modelo, e da mesma loja.
O gatilho é por loja: fica gravado com a loja de quem criou e só dispara para registros daquela loja.
Se a edição recusar com "Não é possível editar um gatilho padrão!", é um gatilho sem loja: crie um novo no lugar.

O DISPARO, NA ORDEM
Um usuário logado salva o registro com aquela situação. O sistema procura gatilhos da mesma empresa, mesma loja e mesma situação. O envio entra numa fila: é assíncrono, não é instantâneo e não tem prazo prometido. Ao processar, o sistema grava a linha do envio, busca o cliente do registro e manda o e-mail para o endereço do cadastro dele. O assunto é o nome da pesquisa e o corpo traz o nome, a descrição e o link "Clique aqui para responder a pesquisa".
O e-mail sai com o nome da loja e o endereço de e-mail do usuário que salvou a alteração; a resposta do cliente volta para esse endereço.

ONDE CONFERIR
Abra a pesquisa e vá na aba Envios. Cada tentativa é uma linha. Sem nenhuma linha depois da mudança de situação, o gatilho não chegou a rodar — e é esse o dado que vale levar ao chamado. O que cada coluna dessa aba significa está na fonte de leitura dos resultados; não vale repetir aqui. Dois detalhes são do gatilho: nas Referências o link do registro aparece sempre com o rótulo "Pedido", mesmo quando o registro é uma OS, uma venda ou um orçamento; e a coluna "Número do cliente" fica vazia, o que é normal e não indica falha.

O QUE COSTUMA DAR ERRADO
Defeito em aberto no acionamento. Este é o ponto mais importante desta fonte: o disparo automático pode simplesmente não acontecer, com o gatilho montado corretamente, e já houve caso de disparos pararem de um dia para o outro sem ninguém mexer em nada. Não é erro de configuração do cliente e não se resolve refazendo o gatilho. Se a aba Envios não mostra linha nenhuma depois da mudança de situação, abra chamado em vez de ficar repetindo o teste com o cliente.
Situação diferente da escolhida, ou registro de outra loja: não dispara.
Alteração feita sem um usuário logado (rotina automática, integração): não dispara.
Cliente sem e-mail no cadastro: não recebe. A linha aparece na aba Envios sem nome e sem e-mail.
E-mail do cliente na lista de bloqueados do sistema: também não sai.
Não há nova tentativa. A linha do envio é gravada antes de o e-mail sair, então uma tentativa que falhou (cliente sem e-mail, e-mail bloqueado, erro de envio) trava o reenvio daquele gatilho para aquele cliente naquele registro para sempre — corrigir o cadastro do cliente depois não faz a pesquisa sair. O mesmo vale para o reenvio comum: mudar a situação para trás e para frente não reenvia.
Pesquisa Pausada ou Cancelada não aparece na busca do formulário, então não dá para montar o gatilho com ela.
Gatilho não envia por WhatsApp nem por SMS. Compartilhar por WhatsApp existe, mas é ação manual dentro da pesquisa, tratada na fonte de envio.