Playbooks de Integração
Os guias abaixo explicam, em detalhe, como habilitar e testar cada integração:Trigger do Google Calendar
Trigger do Google Drive
Trigger do Outlook
Trigger do OneDrive
Trigger do Microsoft Teams
Trigger do Salesforce
Trigger do Slack
Trigger do 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
- Abra sua automação no painel da CrewAI
- 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
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:- 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:- 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 <trigger>
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: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
:
Acionando Crews a partir de Flows
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
- Consulte os logs de execução para detalhes do erro
- Use
crewai triggers run <nome_do_trigger>
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
- Sempre teste com
crewai triggers run <trigger>
antes de fazer deploy para ver o payload completo - Lembre-se que
crewai run
NÃO simula chamadas de trigger—usecrewai 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