Configurando Serviços e Integrações

Os assistentes do WhatsBotGPT podem se tornar ainda mais poderosos quando conectados a serviços externos e integrações. Este guia explica como configurar e utilizar essas conexões para expandir as capacidades do seu assistente.

Visão Geral das Integrações

O WhatsBotGPT oferece diversas integrações que permitem que seu assistente:

• Acesse informações de sistemas externos
• Execute ações em outras plataformas
• Forneça respostas mais precisas e contextualizadas
• Automatize processos completos de negócio
• Personalize a experiência para cada usuário

Tipos de Integrações Disponíveis

1. Integrações Nativas

São integrações pré-configuradas que podem ser ativadas com poucos cliques:

• Google Calendar: Agendamento e consulta de compromissos
• Stripe: Processamento de pagamentos
• Shopify: Informações de produtos e pedidos
• HubSpot: Gerenciamento de leads e contatos
• Salesforce: Dados de CRM e oportunidades
• WordPress: Conteúdo do seu site
• Google Sheets: Acesso e manipulação de planilhas
• Zapier: Conexão com milhares de outros aplicativos
• Make (Integromat): Automações complexas

2. Integrações via API

Para sistemas que não possuem integração nativa, você pode usar a API do WhatsBotGPT:

• APIs REST: Conecte com qualquer serviço que ofereça API REST
• Webhooks: Configure eventos que disparam ações em sistemas externos
• Endpoints personalizados: Crie pontos de conexão específicos para suas necessidades

3. Bases de Conhecimento Externas

Permitem que seu assistente acesse informações de fontes externas:

• Documentos: PDF, Word, Excel, etc.
• URLs: Páginas web específicas
• Bancos de dados: Conexão direta com bancos de dados SQL
• Sistemas de arquivos: Repositórios de documentos

Configurando Integrações Nativas

Passo 1: Acessar o Catálogo de Integrações

1. Faça login na sua conta WhatsBotGPT
2. Acesse seu assistente
3. Clique na aba Integrações
4. Você verá o catálogo com todas as integrações disponíveis

Passo 2: Selecionar e Ativar uma Integração

Vamos usar o Google Calendar como exemplo:

1. No catálogo, localize Google Calendar
2. Clique em Configurar
3. Clique em Conectar com Google
4. Faça login na sua conta Google quando solicitado
5. Autorize o acesso ao seu calendário
6. Selecione quais calendários deseja conectar
7. Configure as permissões (leitura, escrita, etc.)
8. Clique em Salvar Configurações

Passo 3: Configurar Comportamentos

Após conectar, você precisa definir como seu assistente usará a integração:

1. Clique em Salvar Comportamentos

Passo 4: Testar a Integração

1. Verifique se o assistente responde corretamente e executa a ação esperada
2. Ajuste as configurações se necessário

Exemplo Prático: Integração com Stripe para Pagamentos

Configuração Inicial

1. Configure quais produtos/serviços estarão disponíveis
2. Defina as opções de pagamento (parcelamento, descontos, etc.)
3. Clique em Salvar Configurações

Configurando Comportamentos

1. Clique em Salvar Comportamentos

Testando a Integração de Pagamento

• Apresenta as opções de pagamento
• Gera um link de pagamento
• Confirma quando o pagamento é concluído

Configurando Integrações via API

Para sistemas que não possuem integração nativa, você pode criar conexões personalizadas:

Passo 1: Criar uma Nova Integração API

1. Na aba Integrações, clique em + Nova Integração
2. Selecione Integração API Personalizada
3. Dê um nome para sua integração
4. Clique em Criar

Passo 2: Configurar Endpoints

1. Clique em Salvar Endpoint
2. Repita para adicionar mais endpoints se necessário

Passo 3: Mapear Respostas

1. Clique em Salvar Mapeamento

Passo 4: Configurar Gatilhos

1. Clique em Salvar Gatilhos

Configurando Bases de Conhecimento Externas

As bases de conhecimento permitem que seu assistente acesse informações específicas:

Passo 1: Adicionar uma Base de Conhecimento

1. Clique em Criar

Passo 2: Adicionar Conteúdo

Para upload de arquivos:

1. Clique em Adicionar Arquivos
2. Selecione os documentos (PDF, DOCX, XLSX, etc.)
3. Aguarde o processamento

Para URLs:

1. Clique em Adicionar URL
2. Digite o endereço da página
3. Configure a profundidade de rastreamento (apenas esta página ou incluir links)
4. Clique em Adicionar

Para banco de dados:

1. Forneça os detalhes de conexão
2. Selecione as tabelas relevantes
3. Configure as permissões (somente leitura recomendado)
4. Teste a conexão

Passo 3: Configurar Utilização

1. Clique em Salvar Configurações

Integrações Avançadas com Webhooks

Os webhooks permitem que sistemas externos notifiquem seu assistente sobre eventos:

Configurando um Webhook Receptor

1. Clique em Criar
2. Copie a URL gerada para configurar no sistema externo

Configurando Ações para Eventos de Webhook

1. Clique em Salvar Ação

Gerenciando Múltiplas Integrações

Quando seu assistente utiliza várias integrações, é importante gerenciá-las adequadamente:

Definindo Prioridades

1. Na aba Integrações, clique em Gerenciar Prioridades
2. Arraste as integrações para reordenar sua prioridade
3. As integrações no topo serão utilizadas primeiro
4. Clique em Salvar Ordem

Monitorando Uso e Desempenho

1. Use esses dados para otimizar suas integrações

Solução de Problemas Comuns

Integração Não Está Sendo Acionada

Verifique:

• Se os gatilhos estão configurados corretamente
• Se as permissões estão ativas
• Se há conflitos com outras integrações de maior prioridade
• Se a integração está habilitada

Erros de Autenticação

Se a integração falha com erros de autenticação:

1. Verifique se as credenciais estão corretas
2. Confirme se os tokens de acesso não expiraram
3. Reconecte a integração se necessário
4. Verifique se a conta externa não tem restrições de acesso

Respostas Incorretas ou Incompletas

Se a integração funciona, mas retorna dados incorretos:

1. Verifique o mapeamento de resposta
2. Teste a API diretamente para confirmar os dados
3. Ajuste as transformações de dados se necessário
4. Verifique se há limitações na API externa

Melhores Práticas para Integrações

• Comece simples: Implemente uma integração de cada vez e teste completamente
• Documente tudo: Mantenha registros de todas as configurações e credenciais
• Monitore regularmente: Verifique o desempenho e erros das integrações
• Teste em ambiente controlado: Sempre teste novas integrações antes de disponibilizar para usuários
• Considere a privacidade: Só compartilhe dados necessários com sistemas externos
• Planeje redundâncias: Tenha planos alternativos caso uma integração falhe
• Mantenha-se atualizado: Revise periodicamente suas integrações para garantir compatibilidade

Exemplos de Casos de Uso

Assistente de Vendas com CRM

Integre seu assistente com Salesforce ou HubSpot para:

• Registrar novos leads automaticamente
• Consultar histórico de clientes durante conversas
• Atualizar oportunidades com base nas interações
• Agendar reuniões com vendedores

Assistente de Suporte com Base de Conhecimento

Conecte seu assistente a documentos de suporte para:

• Responder perguntas técnicas com precisão
• Fornecer links para documentação detalhada
• Manter-se atualizado com as últimas informações
• Escalar para humanos apenas quando necessário

Assistente de E-commerce

Integre com plataformas como Shopify e Stripe para:

• Mostrar catálogo de produtos
• Verificar disponibilidade em tempo real
• Processar pedidos e pagamentos
• Fornecer atualizações de status de entrega

Próximos Passos

Após configurar as integrações básicas, considere:

1. Personalizar as instruções do seu assistente para aproveitar ao máximo as integrações
2. Criar fluxos de conversa específicos para cada integração
3. Treinar sua equipe para entender como as integrações funcionam
4. Coletar feedback dos usuários para identificar oportunidades de melhoria

Para mais informações sobre como personalizar seu assistente, consulte nosso guia sobre Personalizando Instruções e Personalidade.