Emails e Webhooks de Formulários

Quando um formulário é submetido, três coisas podem acontecer além de armazenar a resposta: um email de confirmação para o remetente, um email de notificação para alguém da organização e um webhook para qualquer sistema externo. Cada um é configurado no formulário e todos os três podem coexistir.

Email de confirmação (para o remetente)

Habilite nomeando o campo que contém o endereço de email do remetente (o campo reply-to). Com isso definido, mais um SMTP funcional em Settings → Email, todo remetente recebe uma cópia das próprias respostas.
Assunto e nome do remetente são por formulário. O endereço reply-to é validado e limpo de quebras de linha antes do uso (prevenindo injeção de cabeçalhos SMTP por meio de uma resposta "email" artificiosa).
O envio acontece em segundo plano depois que a submissão é aceita, o visitante não fica esperando pelo salto do email.

Email de notificação para administradores

Um ou mais endereços da organização recebem o conteúdo da submissão; a mensagem inclui o valor de cada campo visível, formatado (listas de checkboxes e endereços renderizados de forma legível).
O endereço IP de origem pode ser incluído como uma linha nesse email (alternador por formulário, ligado por padrão) ou omitido, note que ele também é suprimido quando as regras de formulário/armazenar-IP impedem que IPs sejam registrados.
A notificação passa pelas mesmas configurações de SMTP; os endereços são validados ao salvar.

Webhooks por formulário

Todo formulário também pode fazer POST (ou PUT/PATCH) de suas submissões para um sistema externo, um CRM, um pipeline, um canal de bot:

URL de endpoint + segredo de assinatura - com um segredo definido, a requisição carrega um cabeçalho X-Chinaski-Signature: sha256=… (HMAC do corpo da requisição) para que os receptores possam verificar a autenticidade.
Método, cabeçalhos e template de corpo personalizados - o corpo padrão é um JSON contendo as respostas; um template de corpo personalizado com placeholders {{field_name}} pode moldar o payload para uma API alvo, e cabeçalhos personalizados chave: valor (um por linha) viajam junto.
As respostas do webhook são registradas no log de entregas com retries (backoff de 1/10/60 minutos, três tentativas), a mesma maquinaria de entrega dos webhooks do nível do site, visualizável/reprocessável na administração.

A ressalva do air-gap

Emails e webhooks são saídas para o mundo. Com o modo air-gap habilitado, os formulários ainda aceitam e armazenam submissões, mas emails de confirmação, notificações para administradores e chamadas de webhook são todos ignorados. A revisão local na administração ainda mostra cada resposta.