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)
Repositório de Payloads e Crews de Exemplo
Integração | Quando dispara | Amostras de payload | Crews de exemplo |
---|---|---|---|
Gmail | Novas mensagens, atualização de threads | Payloads de alertas e threads | new-email-crew.py , gmail-alert-crew.py |
Google Calendar | Evento criado/atualizado/iniciado/encerrado/cancelado | Payloads de eventos | calendar-event-crew.py , calendar-meeting-crew.py , calendar-working-location-crew.py |
Google Drive | Arquivo criado/atualizado/excluído | Payloads de arquivos | drive-file-crew.py , drive-file-deletion-crew.py |
Outlook | Novo e‑mail, evento removido | Payloads do Outlook | outlook-message-crew.py , outlook-event-removal-crew.py |
OneDrive | Operações de arquivo (criar, atualizar, compartilhar, excluir) | Payloads do OneDrive | onedrive-file-crew.py |
HubSpot | Registros criados/atualizados (contatos, empresas, negócios) | Payloads do HubSpot | hubspot-company-crew.py , hubspot-contact-crew.py , hubspot-record-crew.py |
Microsoft Teams | Chat criado | Payload do Teams | teams-chat-created-crew.py |
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 está habilitado
- Confira o status da conexão
- Consulte os logs para entender o erro
- Durante o desenvolvimento, garanta que
crewai_trigger_payload
está presente com o payload correto