​

Webhooks

​

Quando usar webhook?

• Seu sistema (CRM, ERP, monitoramento, IFTTT, n8n, Zapier) precisa acionar dispositivos no Portal a partir de um evento dele.
• Você não quer gerenciar token (o webhook_id já e o segredo).
• A ação final e simples: ligar/desligar algo, mandar notificação, executar script.

​

Configurando o webhook

https://portal.unicontrol.me/v1/automations/webhook/{webhook_id}

​

Chamando o webhook

curl -X POST https://portal.unicontrol.me/v1/automations/webhook/abc123xyz \
  -H "Content-Type: application/json" \
  -d '{
    "evento": "porta_aberta",
    "local": "garagem",
    "timestamp": "2026-05-28T14:00:00-03:00"
  }'

​

Usando o payload nas ações

Acao: Notificacao
Mensagem: "Porta aberta em {{ trigger.json.local }}"

​

Boas práticas

• Rotacione webhooks comprometidos: se desconfiar de vazamento, exclua a automação e recrie com novo webhook_id.
• Valide o payload: a automação pode começar com uma condição verificando campos esperados.
• Não exponha em frontend público: o webhook_id na mao errada permite acionar ações na sua casa. Use webhook apenas em sistemas controlados (backend-to-backend, n8n self-hosted, etc.).
• Idempotencia: se o seu sistema externo pode retry, deixe a automação tolerante a chamadas duplicadas (ex: não adicione duas vezes o mesmo item).

​

Webhooks no caminho contrario (Portal → seu sistema)

• Gatilho: o evento que quer monitorar (mudança de estado, horário, etc.)
• Ação: Chamar URL (HTTP request) apontando pro seu endpoint

Acao: Chamar URL
Metodo: POST
URL: https://meu-servico.exemplo.com/portal-hook
Body: { "entity_id": "{{ trigger.entity_id }}", "state": "{{ trigger.to_state.state }}" }