---
title: Integração com Ferramentas Externas
info: Esses fluxos de trabalho focam em trazer dados para dentro e para fora do Twenty através de chamadas de API e webhooks.
image: /images/user-guide/integrations/plug.png
sectionInfo: Automatize processos e integre com ferramentas externas
---

<Frame>
  <img src="/images/user-guide/integrations/plug.png" alt="Header" />
</Frame>

Abaixo estão exemplos de fluxos de trabalho que você poderia implementar para conectar o Twenty com o restante do seu stack.

## Casos de Uso de Ingestão de Dados

### Envio de Formulários Web

**Problema**: Você precisa capturar leads de formulários do site, landing pages ou formulários de contato diretamente no Twenty.

**Solução**: Use gatilhos de webhook para criar registros dos envios de formulários automaticamente.

**Configuração**:

- Crie um fluxo de trabalho com um gatilho de webhook
- Configure o webhook para receber dados do formulário (nome, email, empresa, etc.)
- Defina o método do webhook para POST
- Defina a estrutura esperada do corpo no gatilho

**Gatilho**: Webhook (requisição POST do seu formulário)

**Ações**:

- Pesquisar Registros para verificar se a pessoa/empresa já existe
- Ramificação: Se existir → Atualizar Registro, Se não existir → Criar Registro
- Criar Registro para tarefa de acompanhamento atribuída ao representante de vendas
- Enviar notificação por email para a equipe de vendas

### Sincronização de Dados do Produto

**Problema**: Sua equipe de vendas precisa de visibilidade sobre dados de uso do produto, faturamento ou adoção de recursos armazenados em seu data warehouse.

**Solução**: Sincronize regularmente os dados do produto no Twenty para fornecer aos vendedores contexto sobre suas contas.

**Gatilho**: Em um cronograma (diário ou semanal)

**Ações**:

- Requisição HTTP para a API do seu data warehouse
- Ação de código para processar e formatar os dados
- Use a função Iterador para as etapas seguintes
- Pesquisar Registros para encontrar registros de empresas correspondentes
- Atualizar Registro para adicionar métricas de uso do produto
- Criar Registro para tarefas quando o uso cair abaixo do limite

### Notas de Reunião a partir de Gravadores de Chamadas

**Problema**: Percepções importantes das chamadas de vendas se perdem ou não são documentadas corretamente no CRM.

**Solução**: Crie automaticamente notas e itens de ação a partir de sistemas de gravação de chamadas.

**Gatilho**: Webhook (da plataforma de gravação de chamadas)

**Ações**:

- Ação de código para extrair resumo da reunião e itens de ação
- Pesquisar Registros para encontrar a oportunidade ou contato relacionado
- Criar Registro para uma nota com resumo da reunião
- Criar Registro para tarefas de acompanhamento com base nos itens de ação
- Enviar Email para os participantes com resumo e próximos passos

### Enriquecimento de Dados

**Problema**: Seus registros de contato e empresa carecem de informações demográficas e firmográficas importantes.

**Solução**: Enriqueça automaticamente registros usando provedores de dados externos.

**Gatilho**: Registro é Criado (objeto Pessoas ou Empresas)

**Ações**:

- Requisição HTTP para a API de enriquecimento
- Ação de código para processar a resposta de enriquecimento
- Use a função Iterador para as etapas seguintes
- Atualizar Registro com informações adicionais da empresa/contato
- Criar Registro para tarefa de vendas se prospecto de alto valor for identificado
- Enviar alerta por Email se o enriquecimento revelar sinais de compra chave

## Casos de Uso de Distribuição de Dados

### Gestão de Assinantes da Newsletter

**Problema**: Você deseja enviar e-mails de marketing para segmentos específicos dos dados do seu CRM usando ferramentas de e-mail especializadas.

**Solução**: Exporte listas de assinantes para sua plataforma de marketing por e-mail quando necessário.

**Configuração**: Crie uma visualização no Twenty com todos os destinatários da newsletter

**Gatilho**: Lançamento Manual (quando nenhum registro é selecionado)

**Ações**:

- Pesquisar Registros usando os critérios de visualização da newsletter
- Ação de código para formatar endereços de e-mail para sua plataforma de email
- Requisição HTTP para adicionar assinantes à sua ferramenta de marketing por e-mail
- Criar Registro para rastreamento de campanhas
- Enviar confirmação por e-mail para a equipe de marketing

### Gatilhos de Sequência de Emails

**Problema**: Você deseja acionar sequências de e-mail sofisticadas baseadas em eventos do CRM usando ferramentas de automação de e-mail dedicadas.

**Solução**: Envie novos leads ou clientes para sua plataforma de automação de e-mail quando eventos específicos ocorrerem.

**Gatilho**: Registro é Criado (objeto Pessoas com critérios específicos)

**Ações**:

- Ação de código para determinar a sequência de e-mail apropriada
- Requisição HTTP para adicionar contato à plataforma de automação de e-mail
- Atualizar Registro para rastrear participação na sequência
- Criar Registro para tarefa de acompanhamento para monitorar o engajamento

### Integração de Pontuação de Leads

**Problema**: Você precisa de uma pontuação de leads sofisticada que combine dados do CRM com sinais externos.

**Solução**: Envie dados de leads para ferramentas de pontuação externas ou implemente lógica de pontuação em fluxos de trabalho.

**Opção 1 - Ferramenta Externa**:

**Gatilho**: Registro é Atualizado (objeto Pessoas)

**Ações**:

- Requisição HTTP para enviar dados de leads para a plataforma de pontuação
- Ação de código para processar resposta de pontuação
- Atualizar Registro com pontuação de lead
- Criar Registro para tarefa de vendas se a pontuação exceder o limite

**Opção 2 - Lógica Interna**:

**Gatilho**: Registro é Atualizado (objeto Pessoas)

**Ações**:

- Ação de código com algoritmo de pontuação (tamanho da empresa, indústria, comportamento)
- Atualizar Registro com pontuação calculada
- Enviar alerta por e-mail para representante de vendas para leads com alta pontuação

### Geração de Faturas

**Problema**: Quando os negócios fecham, seu sistema de faturamento precisa ser atualizado com as informações do cliente e do negócio.

**Solução**: Envie automaticamente dados do negócio para seu sistema de faturamento quando as oportunidades forem ganhas.

**Gatilho**: Registro é Atualizado (objeto Oportunidades, Estágio = "Fechado Ganho")

**Ações**:

- Pesquisar Registros para obter informações completas dos clientes
- Ação de código para formatar dados para o sistema de faturamento
- Requisição HTTP para criar cliente na plataforma de faturamento
- Requisição HTTP para gerar fatura
- Atualizar Registro para armazenar referência da fatura
- Enviar Email para a equipe financeira com detalhes da fatura

## Padrões Avançados de Integração

### Sincronização Bidirecional

**Problema**: Você precisa manter os dados sincronizados entre o Twenty e outro sistema em ambas as direções.

**Solução**: Combine fluxos de trabalho agendados com gatilhos de webhook para sincronização em tempo real.

**De Twenty para Sistema Externo**:

**Gatilho**: Registro é Atualizado (qualquer objeto relevante)

**Ações**:

- Requisição HTTP para atualizar sistema externo
- Atualizar Registro para rastrear status de sincronização e carimbo de data/hora

**De Sistema Externo para Twenty**:

**Gatilho**: Webhook (do sistema externo)

**Ações**:

- Pesquisar Registros para encontrar registro correspondente
- Atualizar Registro com novos dados do sistema externo
- Criar Registro para tarefa de resolução de conflitos, se necessário

### Processamento de Dados em Múltiplas Etapas

**Problema**: Dados de fontes externas precisam de processamento complexo antes de serem usados no Twenty.

**Solução**: Use ações de código para transformação e validação de dados.

**Gatilho**: Webhook ou Em um Agendamento

**Ações**:

- Ação de código para validar formato de dados recebidos
- Ação de código para transformar estrutura de dados
- Ação de código para aplicar regras de negócios e cálculos
- Pesquisar Registros para verificar duplicados
- Criar ou Atualizar Registro com dados processados
- Enviar alerta por e-mail se forem detectados problemas de qualidade de dados

## Dicas de Implementação

- Armazene chaves de API com segurança em Configurações → API e Webhooks
- Use HTTPS para todas as chamadas de API externas
- Fique atento aos limites de taxa de API - use fluxos de trabalho agendados quando possível
- Considere atualizações em lote "Em um Agendamento" quando o processamento em tempo real não for necessário
- Lembre-se do limite de 100 fluxos de trabalho simultâneos por espaço de trabalho - use disponibilidade "Em Massa" para gatilhos manuais ao processar vários registros (veja [Recursos do Fluxo de Trabalho](/l/pt/user-guide/workflows/workflow-features) para detalhes)
- Teste com dados de amostra antes de ativar fluxos de trabalho

Para solucionar problemas de integração, veja nosso guia [Solução de Problemas de Fluxo de Trabalho](/l/pt/user-guide/workflows/workflow-troubleshooting). Para ajuda com a implementação de integrações complexas, considere nossos [Serviços Profissionais](/l/pt/user-guide/workflows/professional-services).
