github-actions[bot]
9bc5486d0d
Created by Github action --------- Co-authored-by: github-actions <github-actions@twenty.com>
221 lines
9.3 KiB
Plaintext
221 lines
9.3 KiB
Plaintext
---
|
|
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).
|