> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://helpdesk.closum.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Closum: Triggers, Actions e Tools


O **Marketplace do Closum** permite ligar a aplicação Closum a outras plataformas, criando automações entre diferentes sistemas de forma simples e escalável.

Neste contexto, os **Triggers e Actions apresentados neste artigo são eventos e operações da própria aplicação Closum**, que podem ser utilizados para **integrar e sincronizar dados com outras ferramentas** (ex: CRMs, plataformas de marketing, sistemas internos, etc.).

A lógica mantém-se simples:
**Triggers (Closum) → Tools → Actions (Closum ou outras aplicações)**

## ${color}[#000000](O que são Triggers)

Os **Triggers** são eventos que acontecem dentro da aplicação Closum e que podem iniciar uma automação, seja para agir dentro do Closum ou para comunicar com sistemas externos.

### Triggers disponíveis (Closum)

* **Novo Lead (API)**
Dispara quando um novo lead é criado no Closum via API.
* **Contacto Atualizado**
Ativado sempre que um contacto é alterado no Closum.
* **SMS: Estado Atualizado**
Dispara quando o estado de um SMS é atualizado (ex: enviado, entregue, falhado).
* **WhatsApp: Mensagem Recebida**
Ativado quando uma mensagem é recebida via WhatsApp no Closum.
👉 Exemplo de integração:
Mensagem recebida no WhatsApp (Closum) → Trigger ativa → enviar dados para um CRM externo.

## ${color}[#000000](O que são Actions)

As **Actions** são operações que o Closum pode executar, seja internamente ou como resposta a eventos provenientes de outras aplicações.

Estas actions podem ser usadas:

* Como consequência de um trigger do Closum
* Ou como destino de triggers vindos de outras ferramentas

### Actions disponíveis (Closum)

#### Gestão de Leads

* **Lead: Adicionar Lead**
* **Lead: Atualizar Lead**
* **Lead: Editar por Email**
* **Lead: Ver Detalhes**
* **Lead: Eliminar**

#### Comunicação

* **Email: Enviar Modelo**
* **SMS: Envio Único**
* **WhatsApp: Enviar template de mensagem**

#### Gestão de Contactos

* **Contacto: Adicionar Tag**
* **Contacto: Adicionar Tag por Email**
* **Contacto: Remover**
* **Contacto: Remover Tag por Email**

#### Outros

* **SMS: Ler Créditos**
* **Tag: Criar nova**
* **Solicitação API personalizada**

👉 Exemplo de integração:
Novo lead criado num formulário externo → Action no Closum cria automaticamente o lead.

## O papel das Tools

As **Tools** permitem transformar dados, controlar lógica e adaptar os fluxos entre diferentes sistemas.

São especialmente importantes em integrações, onde:

* Os dados vêm em formatos diferentes
* É necessário validar ou enriquecer informação
* Existem decisões condicionais entre sistemas

### Exemplos de uso em integrações

* Converter formatos de telefone antes de enviar para outra app
* Fazer parsing de JSON vindo de APIs externas
* Aplicar condições antes de criar ou atualizar leads
* Distribuir leads por equipas (round robin)
* Criar delays entre comunicações multicanal

## ${color}[#000000](Como funciona numa integração real)

### Exemplo 1: Closum → CRM externo

* Trigger: WhatsApp mensagem recebida no Closum
* Tool: Parse e estruturar dados
* Action: Enviar dados para API externa

### Exemplo 2: Ferramenta externa → Closum

* Trigger: Novo contacto numa plataforma externa
* Tool: Formatar dados
* Action: Criar lead no Closum
* Action: Enviar mensagem automática via WhatsApp

### Exemplo 3: Sincronização bidirecional

* Trigger: Contacto atualizado no Closum
* Action: Atualizar CRM externo
* Trigger: Alteração no CRM
* Action: Atualizar contacto no Closum

## ${color}[#000000](Boas práticas para integrações)

* Garantir consistência de dados entre sistemas
* Usar Tools para normalizar informação
* Evitar duplicação de leads
* Implementar condições (branching) para controlar fluxos
* Monitorizar erros em chamadas API

## ${color}[#000000](Conclusão)

No Marketplace do Closum, os **Triggers e Actions da aplicação funcionam como pontos de ligação entre sistemas**.
Isto permite:
* Automatizar processos entre diferentes ferramentas
* Centralizar comunicação e dados no Closum
* Escalar operações sem aumentar complexidade manual


Ao combinar Triggers, Actions e Tools, é possível criar integrações robustas e adaptadas a qualquer fluxo de negócio.