Alertas de câmbio

O alerta de câmbio acompanha a cotação de um par de moedas e chama um endereço (webhook) quando a condição que você definiu é atingida. Serve, por exemplo, para disparar uma campanha pela API de Campanhas quando o dólar cai.

# Onde fica

1. No seletor de módulo, no topo, escolha CRM.
2. No rodapé do menu, clique em Configurações.
3. Clique em Integrações (API / Webhooks).
4. Procure o bloco Alertas de Câmbio, ao lado de Chaves de API.

# Quem pode usar

Quem tem a página Configurações liberada para o perfil e enxerga o módulo CRM.

# Criar um alerta

1. Clique em Novo alerta de câmbio.
2. Deixe a chave Ativo ligada.
3. Preencha Par de moeda, Campo monitorado, Condição e Threshold.
4. Preencha Webhook URL e escolha o Método.
5. Se o endereço exigir autenticação, informe os cabeçalhos em Headers (JSON).
6. Monte o corpo da chamada em Body template (JSON).
7. Clique em Salvar. Aparece “Alerta salvo!”.

# Campos

Marcadores que você pode usar no corpo: {{value}} (o valor lido do campo monitorado), {{pair}}, {{field}}, {{last}}, {{change}}, {{open}}, {{previousClose}}, {{name}} e {{time}}. Marcador sem valor é trocado por vazio.

# O sinal do campo change

O campo change é a variação percentual com sinal: negativo é queda, positivo é alta.

• Para “caiu 1,1% ou mais”, use ≤ Menor ou igual com -1.1.
• Para “subiu 1,1% ou mais”, use ≥ Maior ou igual com 1.1.

Se você configurar, por exemplo, change ≤ 1.1, a condição é atendida em praticamente todo dia útil. A tela mostra o aviso, oferece o botão Corrigir para -1.1 e, se você salvar assim, pede a confirmação “Salvar condição que dispara quase todo dia?”. Na lista, o alerta fica com o selo Condição sempre atendida.

# Quando o alerta dispara

• A cotação é verificada de hora em hora, das 9h às 18h (horário de Brasília), em dias úteis.
• Cada alerta dispara no máximo uma vez por dia. Depois de disparar, ele volta a valer às 9h do próximo dia útil. A linha do alerta mostra Próximo disparo disponível em.
• A linha também mostra Última verificação, o Valor lido e o Último disparo.

# Testar

• Ícone de envio na linha do alerta (Testar agora): chama o webhook daquele alerta na hora, sem olhar a condição nem o limite de um disparo por dia. Aparece “Webhook de teste enviado” com o código de resposta do seu endereço. Só funciona com o alerta ativo e não conta como o disparo do dia.
• Botão Testar agora, no rodapé do bloco: roda a verificação de todos os alertas ativos naquele momento, mesmo fora do horário. Só dispara os que atendem a condição e ainda não dispararam no dia. Aparece “Verificação concluída”, com quantos foram verificados e quantos dispararam.

# Editar, duplicar e excluir

• Editar: abre o alerta para alteração.
• Duplicar (ícone de cópia): abre um alerta novo com os mesmos dados, desligado.
• Lixeira: remove o alerta na hora, sem pedir confirmação. Aparece “Alerta removido.”.

# Regras e limites

• JSON malformado em Headers (JSON) ou em Body template (JSON) é salvo como vazio, sem aviso. Confira o JSON antes de salvar e abra o alerta de novo para conferir.
• O alerta só chama o endereço. O que acontece depois (enviar campanha, avisar a equipe) depende do sistema que recebe a chamada.
• Para disparar uma campanha do próprio DeepLead, aponte Webhook URL para a API de Campanhas, informe a chave em Headers (JSON) e monte o corpo como em Webhooks e chaves de API.

# Problemas comuns

# Veja também

• Webhooks e chaves de API
• Configurações: como a tela se organiza
• Como funciona o suporte