Zapier

Importante: A integração do Zapier permite conectar o ZappWay a mais de 5.000 aplicativos sem escrever código. Automatize fluxos de trabalho, sincronize dados entre sistemas e amplie os recursos dos seus funcionários de IA em toda a sua pilha de tecnologia.

​

🔢 Índice

1. Overview
2. Prerequisites
3. Getting Started
4. Available Actions
5. Common Workflows
6. Advanced Use Cases
7. Troubleshooting
8. Best Practices

​

1. Visão geral

​

O que é Zapier?

​

Principais recursos

• Mais de 5.000 integrações de aplicativos: conecte-se a ferramentas populares como Gmail, Slack, Planilhas Google, Salesforce e muito mais
• Não é necessário código: crie automações com uma interface visual simples
• Ações de funcionários de IA: consulte seus funcionários de IA, faça upload de arquivos e pesquise armazenamentos de dados
• Automação em tempo real: os fluxos de trabalho são executados automaticamente quando acionados
• Fluxos de trabalho de várias etapas: encadeie várias ações para automações complexas

​

O que você pode fazer

• Envie envios de formulários para o seu CRM automaticamente
• Carregar novos documentos para armazenamentos de dados a partir do armazenamento em nuvem
• Consulte funcionários de IA de outros aplicativos
• Pesquise datastores e use resultados em outros fluxos de trabalho
• Criar pipelines automatizados de suporte ao cliente
• Sincronize dados entre o ZappWay e suas ferramentas de negócios

​

2. Pré-requisitos

​

Antes de começar

• Conta ZappWay ativa
• Pelo menos um funcionário de IA criado
• Chave API do painel ZappWay

• Conta Zapier gratuita ou paga
• Inscreva-se em zapier.com se necessário

1. Log in to ZappWay Dashboard
2. Navigate to Settings → API Keys
3. Click “Create API Key”
4. Copy the key and store it securely
5. You’ll need this key to authenticate Zapier

​

3. Primeiros passos

​

Etapa 1: Instale o aplicativo ZappWay no Zapier

1. Log in to your Zapier account
2. Go to My Apps in the left sidebar
3. Click “Add Connection”
4. Search for “ZappWay”
5. Click on the ZappWay app

​

Etapa 2: Conecte sua conta ZappWay

1. When prompted, enter your ZappWay API Key
2. Click “Yes, Continue”
3. Zapier will test the connection
4. Once successful, you’ll see “Connection successful”

​

Etapa 3: Crie seu primeiro Zap

1. Click “Create Zap” in Zapier
2. Choose a Trigger (the event that starts the automation)
   • Example: “New Email in Gmail”
3. Choose an Action (what happens next)
   • Example: “Query AI Employee in ZappWay”
4. Configure the action with your specific settings
5. Test the Zap to ensure it works
6. Turn on the Zap

​

4. Ações disponíveis

​

Ação 1: Consultar funcionário da IA

• Respostas automatizadas de suporte ao cliente
• Geração de conteúdo a partir de gatilhos
• Tomada de decisão em fluxos de trabalho
• Enriquecimento de dados com IA

AI Employee: Customer Support AI
Question: What is our refund policy for orders over $100?
Conversation ID: (leave empty for new conversation)
Auto-truncate: Yes

• answer - A resposta do funcionário da IA
• query - A pergunta original que você fez
• conversationId - ID para continuar esta conversa
• sources - Documentos utilizados para gerar a resposta

{
  "answer": "For orders over $100, customers can request a full refund within 30 days of purchase. They need to contact support@company.com with their order number. Refunds are processed within 5-7 business days.",
  "query": "What is our refund policy for orders over $100?",
  "conversationId": "conv_abc123def456",
  "sources": [
    {
      "text": "Refund policy section from company handbook",
      "source": "https://docs.company.com/policies/refunds",
      "score": 0.89
    }
  ]
}

​

Ação 2: fazer upload do arquivo para o armazenamento de dados

• Sincronize automaticamente documentos do Google Drive para o armazenamento de dados
• Carregar novos contratos ou faturas para análise de IA
• Mantenha a base de conhecimento atualizada com os arquivos mais recentes
• Arquive documentos importantes com metadados

Datastore: Product Documentation
File: [file from previous step]
File Name: product-specs-v2.pdf
Metadata: {"department": "Product", "version": "2.0", "date": "2025-01-15"}

• Documentos: PDF, DOC, DOCX, TXT, MD
• Planilhas: CSV, XLS, XLSX
• Apresentações: PPT, PPTX
• E mais

• success - Se o upload foi bem-sucedido
• fileId - Identificador exclusivo do arquivo enviado
• fileName - Nome do arquivo enviado
• fileSize - Tamanho em bytes
• status - Status do processamento (processamento, concluído, falhado)
• message - Informações adicionais de status

​

Ação 3: Pesquisar armazenamento de dados

• Encontre documentos relevantes para consultas específicas
• Extrair informações da base de conhecimento
• Enriqueça os dados com o contexto dos documentos
• Validar informações em relação ao conhecimento armazenado

Datastore: HR Policies
Search Query: employee vacation policy guidelines
Number of Results: 5
Metadata Filters: {"department": "HR", "year": "2024"}

• results[]text - O conteúdo de texto relevante encontrado
• results[]source - Documento de origem original ou URL
• results[]score - Pontuação de relevância (0-1, maior é mais relevante)
• results[]metadata - Informações adicionais sobre a fonte

{
  "results": [
    {
      "text": "Employees are entitled to 15 days of paid vacation per year. Vacation must be requested at least 2 weeks in advance through the HR portal.",
      "source": "https://docs.company.com/hr/vacation-policy.pdf",
      "score": 0.92,
      "metadata": {
        "fileName": "vacation-policy.pdf",
        "department": "HR",
        "lastUpdated": "2024-01-15"
      }
    },
    {
      "text": "New employees receive 10 vacation days in their first year, increasing to 15 days after one year of service.",
      "source": "https://docs.company.com/hr/benefits-overview.pdf",
      "score": 0.85,
      "metadata": {
        "fileName": "benefits-overview.pdf",
        "department": "HR"
      }
    }
  ]
}

​

5. Fluxos de trabalho comuns

​

Fluxo de trabalho 1: Suporte automatizado ao cliente (Gmail → Funcionário de IA → Gmail)

• Filtro: Emails enviados para support@company.com
• Etiqueta: Não lida

• Funcionário de IA: IA de suporte ao cliente
• Pergunta: Corpo do e-mail
• Use o tópico de e-mail como contexto de conversa

• Para: E-mail do remetente original
• Assunto: Re: Assunto Original
• Corpo: Resposta do funcionário da IA

• Respostas instantâneas às perguntas dos clientes
• Informações consistentes e precisas
• Cobertura de suporte 24 horas por dia, 7 dias por semana
• Carga de trabalho reduzida da equipe de suporte

​

Fluxo de trabalho 2: sincronização de documentos (Google Drive → ZappWay Datastore)

• Pasta: /Documentos da Empresa/Documentação do Produto

• Datastore: base de conhecimento do produto
• Arquivo: Arquivo do Google Drive
• Nome do arquivo: Nome do arquivo original
• Metadados:

{
  "source": "Google Drive",
  "uploadedBy": "File Owner",
  "uploadDate": "Current Date",
  "folder": "Product Documentation"
}

• Base de conhecimento sempre atualizada
• Não é necessário upload manual
• Marcação automática de metadados
• Gerenciamento centralizado de documentos

​

Fluxo de trabalho 3: Qualificação de leads (Typeform → Funcionário de IA → Salesforce)

• Formulário: Formulário de Contato

• Funcionário de IA: IA de qualificação de leads
• Pergunta:

Qualify this lead:
Company: [Company Name]
Industry: [Industry]
Budget: [Budget Range]
Needs: [Describe Your Needs]

Provide: lead score (1-10), qualification summary, next action

• Fonte do lead: Formulário do site
• Empresa: Nome da Empresa
• Pontuação de lead: pontuação de IA da resposta
• Descrição: Resumo de IA
• Status: próxima ação recomendada pela IA

• Qualificação imediata de leads
• Critérios de pontuação consistentes
• Acompanhamento de vendas mais rápido
• Melhor priorização de leads

​

Fluxo de trabalho 4: Criação de conteúdo (RSS → Funcionário de IA → WordPress)

• URL do feed: https://industry-news.com/rss

• Funcionário de IA: Escritor de conteúdo AI
• Pergunta:

Write a 500-word blog post about this topic:

Title: [RSS Item Title]
Summary: [RSS Item Description]

Include: introduction, key points, conclusion, and SEO keywords

• Título: Baseado na resposta da IA
• Conteúdo: Artigo gerado por IA
• Status: Rascunho (para revisão)
• Categoria: Notícias da Indústria
• Tags: palavras-chave sugeridas por IA

• Pipeline de conteúdo automatizado
• Cronograma de publicação consistente
• Conteúdo otimizado para SEO
• Revisão editorial antes da publicação

​

Fluxo de trabalho 5: Classificação de tickets de suporte (Zendesk → Funcionário de IA → Zendesk)

• Funcionário AI: Classificação de ingressos AI
• Pergunta:

Analyze this support ticket:

Subject: [Ticket Subject]
Description: [Ticket Description]

Provide:
1. Category (Billing, Technical, Account, General)
2. Priority (Low, Medium, High, Critical)
3. Suggested department
4. Initial response suggestion

• ID do bilhete: ID do bilhete de gatilho
• Categoria: Categoria IA
• Prioridade: Prioridade AI
• Grupo Designado: Departamento de IA
• Nota interna: Resposta inicial da IA

• Roteamento de tickets mais rápido
• Categorização consistente
• Melhor alocação de recursos
• Respostas sugeridas para agentes

​

6. Casos de uso avançados

​

Enriquecimento de leads em várias etapas

1. Trigger: New Row (Google Sheets) - new lead added
2. Action 1: Search Datastore (ZappWay) - find company info
3. Action 2: HTTP Request - get additional data from external API
4. Action 3: Query AI Employee (ZappWay) - analyze and score lead
5. Action 4: Update Row (Google Sheets) - add enriched data
6. Action 5: Send Slack Message - notify sales team if high score

​

Processamento Inteligente de Documentos

1. Trigger: New Email Attachment (Gmail) - invoice received
2. Action 1: Upload File to Datastore (ZappWay) - store invoice
3. Action 2: Query AI Employee (ZappWay) - extract invoice data
4. Action 3: Create Row (Google Sheets) - log invoice details
5. Action 4: Create Card (Trello) - task for accounts payable
6. Filter: Only if amount greater than $1,000
7. Action 5: Send Email (Gmail) - approval request to manager

​

Manutenção da base de conhecimento

1. Trigger: Schedule (Zapier) - runs daily at 9 AM
2. Action 1: Find Files (Google Drive) - modified in last 24 hours
3. Loop: For each modified file:
   • Action 2: Upload File to Datastore (ZappWay)
   • Action 3: Send Slack Message - notify team of update
4. Action 4: Create Summary (Google Docs) - daily changes report

​

Análise de feedback do cliente

1. Trigger: New Response (Google Forms) - customer feedback
2. Action 1: Query AI Employee (ZappWay) - analyze sentiment
3. Action 2: Add Row (Google Sheets) - log feedback with sentiment
4. Filter: If sentiment is negative
5. Action 3: Create Issue (Jira) - for product team
6. Action 4: Send Email (Gmail) - follow-up with customer

​

7. Solução de problemas

​

Problemas de conexão

1. Verify API Key:
   • Check that API key is copied correctly (no extra spaces)
   • Ensure API key hasn’t expired
   • Regenerate key if necessary
2. Check Permissions:
   • API key must have appropriate permissions
   • Verify account is active and in good standing
3. Test Connection:
   • Click “Test” in Zapier connection settings
   • Check error message for specific issue

​

Zap não dispara

1. Check Zap Status:
   • Ensure Zap is turned ON (not paused)
   • Look for error messages in Zap history
2. Verify Trigger Settings:
   • Confirm trigger app is properly connected
   • Check trigger filters and conditions
   • Test trigger manually
3. Review Task History:
   • Go to Zap History in Zapier
   • Check if tasks are appearing but failing
   • Review error logs for specific failures

​

Funcionário de IA não responde corretamente

1. Check Query Format:
   • Ensure question is clear and specific
   • Remove any special characters that might cause issues
   • Try shorter, more focused queries
2. Verify AI Employee Configuration:
   • Test AI Employee directly in ZappWay dashboard
   • Ensure datastores are connected properly
   • Check that content is indexed (status: “Ready”)
3. Review Instructions:
   • AI Employee instructions might need refinement
   • Add more specific guidelines for the types of questions from Zapier

​

Falhas no upload de arquivos

1. Check File Size:
   • Files must be under 50MB (typical limit)
   • Split large files if necessary
2. Verify File Format:
   • Ensure file type is supported
   • Check that file isn’t corrupted
3. Check Datastore:
   • Verify datastore exists and is accessible
   • Ensure you have permission to upload to that datastore
4. Review File Source:
   • If file comes from another Zap step, ensure it’s downloading correctly
   • Try with a test file first

​

A pesquisa não retorna resultados

1. Query Too Specific:
   • Try broader search terms
   • Use synonyms or related keywords
2. Datastore Empty:
   • Verify datastore has content
   • Check that files have been processed (status: “Ready”)
3. Metadata Filters:
   • Remove or adjust metadata filters
   • Filters might be too restrictive

​

8. Melhores práticas

​

Design de fluxo de trabalho

• Fluxos de trabalho claros e de propósito único
• 3-5 passos no máximo ao iniciar
• Gatilhos bem definidos

• Fluxos de trabalho multifiliais excessivamente complexos
• Muitas etapas condicionais
• Critérios de sucesso pouco claros

1. Teste cada etapa individualmente
2. Execute o fluxo de trabalho completo com dados de teste
3. Verifique a saída nos aplicativos de destino
4. Verifique casos extremos (dados ausentes, erros)

Example: Only process high-priority tickets

Filter:
- (Priority) exactly matches "High"
OR
- (Keywords in Subject) contains "urgent" OR "critical"

​

Tratamento de erros

1. Configurações do Zapier → Notificações
2. Ative “Notifique-me sobre erros do Zap”
3. Escolha a frequência de notificação

Path A: If AI Employee responds successfully
  → Continue normal workflow

Path B: If AI Employee fails
  → Send notification to team
  → Log error to spreadsheet
  → Create manual task

• Habilite novas tentativas automáticas no Zapier
• Defina intervalos de repetição apropriados
• Considere uma retirada exponencial para limites de taxas

​

Otimização de desempenho

❌ Bad:
1. Get data from App A
2. Format data
3. Get more data from App B
4. Format data again
5. Query AI Employee
6. Format AI response
7. Send to App C

✅ Good:
1. Get data from App A and B
2. Format once
3. Query AI Employee
4. Send to App C

• Carregue vários arquivos em uma ação (se compatível)
• Processar matrizes de dados
• Use looping para ações repetidas

• Verifique regularmente o consumo de tarefas do Zapier
• Otimize fluxos de trabalho para usar menos tarefas
• Considere atualizar o plano se atingir os limites de forma consistente

​

Segurança

• Nunca registre chaves de API em saídas do Zap
• Tenha cuidado com as PII do cliente nos fluxos de trabalho
• Use a criptografia integrada do Zapier para valores armazenados
• Gire regularmente as chaves de API

• Compartilhe Zaps apenas com membros da equipe que precisam de acesso
• Use chaves de API separadas para ambientes diferentes
• Revogar chaves de API imediatamente se comprometidas

• Siga os requisitos do GDPR e CCPA
• Não armazene dados pessoais desnecessariamente
• Implementar políticas de retenção de dados
• Permitir que os clientes solicitem a exclusão de dados

​

Manutenção

• Verifique as taxas de erro do Zap
• Revise o histórico de tarefas em busca de falhas
• Teste fluxos de trabalho críticos

• Analisar o uso e os custos das tarefas
• Otimize Zaps executados com frequência
• Atualizar instruções de funcionários de IA com base no desempenho
• Arquivar ou excluir Zaps não utilizados

• Grande revisão do fluxo de trabalho, se necessário
• Revise todos os aplicativos conectados
• Atualizar documentação
• Treinar equipe em novos recursos

• Finalidade e lógica de negócios
• Condições de gatilho
• Resultados esperados
• Abordagem de tratamento de erros
• Quem contatar se surgirem problemas
• Data da última revisão

​

📞 Suporte e Recursos

​

Obtendo ajuda

• E-mail: support@zappway.ai
• Bate-papo ao vivo no painel
• Inclui: Zap ID, mensagens de erro, capturas de tela

• Central de Ajuda do Zapier
• Fórum da comunidade
• Chat ao vivo (planos pagos)

• Documentação da API ZappWay
• Documentação da plataforma Zapier
• Guia do funcionário de IA
• Documentação do Datastore

​

Opinião

• Solicite novas ações do ZappWay via support@zappway.ai
• Vote nas solicitações de recursos do Zapier em sua comunidade

​

✅ Referência rápida

​

Lista de verificação de configuração

✓ ZappWay account created
✓ API key generated and secured
✓ Zapier account created
✓ ZappWay app connected in Zapier
✓ First Zap created and tested
✓ Error notifications configured
✓ Workflow documented

​

Ações disponíveis

​

Aplicativos de gatilho comuns

• Gmail - Novos e-mails
• Formulários Google - Envios de formulários
• Google Drive - Arquivos novos/atualizados
• Typeform - Respostas do formulário
• Webhooks - Gatilhos personalizados
• Programação - Automação baseada em tempo
• Planilhas Google - Linhas novas/atualizadas

​

Exemplo de modelos Zap

Gmail (New Email) → Query AI Employee → Send Gmail

Google Drive (New File) → Upload to Datastore

Typeform (New Entry) → Query AI Employee → Create Salesforce Lead

RSS (New Item) → Query AI Employee → Create WordPress Post