> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Visão Geral de Triggers
> Entenda como os triggers da CrewAI AMP funcionam, como gerenciá-los e onde encontrar playbooks específicos de integração
Os triggers da CrewAI AMP conectam suas automações a eventos em tempo real nas ferramentas que sua equipe já usa. Em vez de fazer polling ou depender de execuções manuais, os triggers escutam mudanças — novos e‑mails, atualizações de calendário, alterações no CRM — e iniciam imediatamente a crew ou flow que você definiu.
### Playbooks de Integração
Os guias abaixo explicam, em detalhe, como habilitar e testar cada integração:
Dispare crews quando novos e‑mails chegarem ou threads forem atualizadas.
{" "}
Reaja a eventos de calendário criados, atualizados ou cancelados.
{" "}
Monitore uploads, edições e exclusões de arquivos no Drive.
{" "}
Automatize respostas a novos e‑mails ou eventos removidos no Outlook.
{" "}
Audite atividade e compartilhamentos de arquivos no OneDrive.
{" "}
Inicie workflows quando novos chats forem criados no Teams.
{" "}
Execute automações a partir de workflows e eventos de ciclo de vida no
HubSpot.
{" "}
Conecte processos do Salesforce às suas crews para automação de CRM.
{" "}
Dispare crews diretamente de comandos slash no Slack.
Integre a CrewAI com milhares de apps suportados pelo Zapier.
## Capacidades dos Triggers
Com triggers você pode:
* **Responder em tempo real** – Executar workflows automaticamente quando condições forem atendidas
* **Integrar com sistemas externos** – Conectar Gmail, Outlook, OneDrive, JIRA, Slack, Stripe e muito mais
* **Escalar automações** – Lidar com alto volume de eventos sem intervenção manual
* **Manter contexto** – Acessar dados do trigger dentro das suas crews e flows
## Gerenciando Triggers
### Visualizando Triggers Disponíveis
1. Abra sua automação no painel da CrewAI
2. Clique na aba **Triggers** para listar todas as integrações disponíveis
### Habilitando e Desabilitando
Cada trigger possui uma chave de ativação:
* **Habilitado (azul)** – Executa a automação quando o evento ocorrer
* **Desabilitado (cinza)** – Ignora eventos
As alterações são aplicadas imediatamente.
### Monitorando Execuções
Use a lista de execuções para acompanhar histórico, status e payloads:
## Construindo Automações Orientadas por Trigger
### Checklist de Configuração
Antes de ativar em produção, confirme que você:
* Conectou a integração em **Tools & Integrations** e concluiu OAuth ou configuração de API
* Habilitou o trigger na automação correta
* Definiu variáveis de ambiente necessárias (tokens, IDs de tenant, segredos)
* Criou tarefas que analisam o payload no primeiro passo da crew/flow
* Decidiu se usará `allow_crewai_trigger_context` para injetar contexto automaticamente
* Configurou monitoramento (webhooks, históricos da CrewAI, alertas externos)
### Testando Triggers Localmente com CLI
A CLI da CrewAI fornece comandos poderosos para ajudá-lo a desenvolver e testar automações orientadas por triggers sem fazer deploy para produção.
#### Listar Triggers Disponíveis
Visualize todos os triggers disponíveis para suas integrações conectadas:
```bash theme={null}
crewai triggers list
```
Este comando exibe todos os triggers disponíveis baseados nas suas integrações conectadas, mostrando:
* Nome da integração e status de conexão
* Tipos de triggers disponíveis
* Nomes e descrições dos triggers
#### Simular Execução de Trigger
Teste sua crew com payloads realistas de triggers antes do deployment:
```bash theme={null}
crewai triggers run
```
Por exemplo:
```bash theme={null}
crewai triggers run microsoft_onedrive/file_changed
```
Este comando:
* Executa sua crew localmente
* Passa um payload de trigger completo e realista
* Simula exatamente como sua crew será chamada em produção
**Notas Importantes de Desenvolvimento:**
* Use `crewai triggers run ` para simular execução de trigger durante o desenvolvimento
* Usar `crewai run` NÃO simulará chamadas de trigger e não passará o payload do trigger
* Após o deployment, sua crew será executada com o payload real do trigger
* Se sua crew espera parâmetros que não estão no payload do trigger, a execução pode falhar
### Triggers com Crews
Suas definições de crew funcionam naturalmente com triggers; basta ter uma tarefa que processe o payload recebido:
```python theme={null}
@CrewBase
class MinhaCrewAutomatizada:
@agent
def pesquisador(self) -> Agent:
return Agent(
config=self.agents_config['pesquisador'],
)
@task
def analisar_payload_trigger(self) -> Task:
return Task(
config=self.tasks_config['analisar_payload_trigger'],
agent=self.pesquisador(),
)
@task
def analisar_conteudo_trigger(self) -> Task:
return Task(
config=self.tasks_config['analisar_dados_trigger'],
agent=self.pesquisador(),
)
```
### Integração com Flows
Flows oferecem controle adicional sobre o uso do payload:
#### Acessando o Payload
Todos os métodos `@start()` podem receber `crewai_trigger_payload`:
```python theme={null}
from crewai.flow import Flow, start, listen
class MeuFlowAutomatizado(Flow):
@start()
def lidar_com_trigger(self, crewai_trigger_payload: dict = None):
if crewai_trigger_payload:
trigger_id = crewai_trigger_payload.get('id')
dados_evento = crewai_trigger_payload.get('payload', {})
self.state.trigger_id = trigger_id
self.state.trigger_type = dados_evento
return dados_evento
return None
@listen(lidar_com_trigger)
def processar_dados(self, dados_trigger):
# ... processa o trigger
```
#### Acionando Crews a partir de Flows
```python theme={null}
@start()
def delegar_para_crew(self, crewai_trigger_payload: dict = None):
crew = MinhaCrewEspecializada()
resultado = crew.crew().kickoff(
inputs={
'parametro_personalizado': "valor_personalizado",
'crewai_trigger_payload': crewai_trigger_payload
},
)
return resultado
```
## Solução de Problemas
**Trigger não dispara:**
* Verifique se o trigger está habilitado na aba Triggers do seu deployment
* Confira o status da conexão em Tools & Integrations
* Garanta que todas as variáveis de ambiente necessárias estão configuradas
**Falhas de execução:**
* Consulte os logs de execução para detalhes do erro
* Use `crewai triggers run ` para testar localmente e ver a estrutura exata do payload
* Verifique se sua crew pode processar o parâmetro `crewai_trigger_payload`
* Garanta que sua crew não espera parâmetros que não estão incluídos no payload do trigger
**Problemas de desenvolvimento:**
* Sempre teste com `crewai triggers run ` antes de fazer deploy para ver o payload completo
* Lembre-se que `crewai run` NÃO simula chamadas de trigger—use `crewai triggers run` em vez disso
* Use `crewai triggers list` para verificar quais triggers estão disponíveis para suas integrações conectadas
* Após o deployment, sua crew receberá o payload real do trigger, então teste minuciosamente localmente primeiro
Os triggers transformam suas implantações CrewAI em sistemas orientados por eventos, integrando-se perfeitamente aos processos e ferramentas já usados pelo seu time.
### Habilitando e Desabilitando
Cada trigger possui uma chave de ativação:
* **Habilitado (azul)** – Executa a automação quando o evento ocorrer
* **Desabilitado (cinza)** – Ignora eventos
As alterações são aplicadas imediatamente.
### Monitorando Execuções
Use a lista de execuções para acompanhar histórico, status e payloads:
## Construindo Automações Orientadas por Trigger
### Checklist de Configuração
Antes de ativar em produção, confirme que você:
* Conectou a integração em **Tools & Integrations** e concluiu OAuth ou configuração de API
* Habilitou o trigger na automação correta
* Definiu variáveis de ambiente necessárias (tokens, IDs de tenant, segredos)
* Criou tarefas que analisam o payload no primeiro passo da crew/flow
* Decidiu se usará `allow_crewai_trigger_context` para injetar contexto automaticamente
* Configurou monitoramento (webhooks, históricos da CrewAI, alertas externos)
### Testando Triggers Localmente com CLI
A CLI da CrewAI fornece comandos poderosos para ajudá-lo a desenvolver e testar automações orientadas por triggers sem fazer deploy para produção.
#### Listar Triggers Disponíveis
Visualize todos os triggers disponíveis para suas integrações conectadas:
```bash theme={null}
crewai triggers list
```
Este comando exibe todos os triggers disponíveis baseados nas suas integrações conectadas, mostrando:
* Nome da integração e status de conexão
* Tipos de triggers disponíveis
* Nomes e descrições dos triggers
#### Simular Execução de Trigger
Teste sua crew com payloads realistas de triggers antes do deployment:
```bash theme={null}
crewai triggers run