Conectar o NetSuite ao Breeze Assistant

Conecte o NetSuite ao Breeze Assistant para acessar e trabalhar com os registros do NetSuite sem sair do HubSpot. Depois de conectar o NetSuite, você pode pedir ao Breeze Assistant para recuperar informações do NetSuite e concluir as ações suportadas nos registros do NetSuite.

Por exemplo, você pode pedir ao Breeze Assistant para resumir o histórico do NetSuite de uma conta, gerar resumos e relatórios usando dados do NetSuite e obter informações financeiras do NetSuite, como histórico de pagamentos e faturas em aberto.

Antes de começar

Antes de conectar o NetSuite ao Breeze Assistant, revise os requisitos e considerações a seguir.

Noções básicas sobre os requisitos

• Antes de conectar o NetSuite ao Breeze Assistant, um administrador do NetSuite deve concluir essas etapas no NetSuite.
• Revise os requisitos para usar o Breeze Assistant.

Compreender limitações e considerações

• O NetSuite é um serviço de terceiros. Ao usar o conector, aplicam-se as políticas de dados e privacidade da Oracle. Revise os Riscos, Controles e Estratégias de Mitigação Associados da Oracle para obter mais informações.
• O serviço NetSuite AI Connector não foi avaliado quanto à conformidade com a HIPAA e não deve ser usado para armazenar, processar ou transmitir ePHI (Electronic Protected Health Information, informações eletrônicas protegidas de saúde). Se você tiver Dados Confidenciais ativados na sua conta da HubSpot, é recomendado não usar o conector. Saiba mais sobre NetSuite e HIPAA.
• Antes de confirmar as alterações, revise as alterações sugeridas pelo Breeze Assistant.
• Você não pode excluir dados do NetSuite por meio do conector.
• Por padrão, os tokens de autenticação são válidos por 48 horas. No NetSuite, você pode estender esse período de validade para um máximo de 30 dias. Quando o token expirar, você deverá autenticar a conexão novamente.

Etapas de administração no NetSuite

Antes de conectar o NetSuite ao Breeze Assistant, um administrador do NetSuite deve concluir as seguintes etapas no NetSuite.

1. Ativar os recursos necessários do NetSuite

Antes de usar o conector do NetSuite no Breeze Assistant, um administrador do NetSuite deve ativar os recursos necessários do SuiteCloud.

1. No NetSuite, acesse Configurar > recursos de ativação da empresa > .
2. Clique na subguia SuiteCloud .
3. Na seção SuiteScript :
• Marque a caixa de seleção Client SuiteScript . Se solicitado, clique em Concordo para aceitar os Termos de serviço do SuiteCloud.
• Marque a caixa de seleção Server SuiteScript . Se solicitado, clique em Concordo para aceitar os Termos de serviço do SuiteCloud.

4. Na seção Gerenciar autenticação, marque a caixa de seleção OAuth 2.0. Se solicitado, clique em Concordo para aceitar os Termos de serviço do SuiteCloud.
5. Na seção SuiteTalk (Serviços da Web), marque a caixa de seleção Serviços da web REST.

6. Clique em Salvar.

2. Configurar uma função do NetSuite para o conector

Cada usuário que precisa de acesso ao conector deve ter uma função NetSuite com as permissões necessárias. Considere criar uma função dedicada para o conector em vez de adicionar essas permissões a uma função existente com acesso mais amplo.

Configurar as permissões de função

1. No NetSuite, acesse Configurar > usuários/funções > Gerenciar funções.
2. Para configurar uma função existente, clique em Editar ao lado da função. Para criar uma função, clique em Novo.
3. Clique na subguia Permissões e, em seguida, em Configuração.
4. Adicione as seguintes permissões:
   • Conexão do servidor MCP: selecione Acesso total . Essa permissão permite que os usuários se conectem ao Serviço do Conector de IA.
   • Fazer login usando tokens de acesso do OAuth 2.0: selecione Acesso total . Esta permissão permite a autenticação OAuth 2.0.
   • Serviços da Web REST: selecione Acesso total se os usuários criarem, recuperarem ou atualizarem registros por meio do MCP Standard Tools SuiteApp.

5. Clique em Salvar.

Observação: depois de criar uma função do NetSuite, pode levar algum tempo para que a função fique disponível. Aguarde até que a função esteja disponível antes de continuar com a configuração.

Adicionar permissões de registro à função

Adicione permissões de registro para os objetos do NetSuite que você deseja que o Breeze Assistant recupere, como pedidos de vendas, faturas e pagamentos de clientes.

1. No NetSuite, alterne para a função de administrador.
2. Navegue até Configurar > usuários/funções > , gerenciar funções.
3. Abra a função que você criou para o conector do NetSuite.
4. Navegue até Transações de permissões > .
5. Adicione permissões para os objetos do NetSuite que você deseja que o Breeze Assistant recupere e defina o nível de acesso para cada permissão como Completo. Por exemplo, você pode adicionar permissões para pedidos de vendas, faturas, pagamentos de clientes ou outros objetos do NetSuite. 
6. Clique em Salvar.

Atribuir a função aos usuários

1. No NetSuite, vá até Listas > Funcionários > Funcionários.
2. Clique em Editar ao lado do usuário para o qual deseja atribuir a função.
3. Navegue até a guiaAcesso.
4. Em Função, pesquise e selecione a função configurada nas etapas anteriores.
5. Clique em Adicionar.
6. Em seguida, clique em Salvar.

Observação: o serviço do conector de IA do NetSuite não pode ser executado na função de administrador ou em qualquer função com acesso total aos recursos do NetSuite. Essa proteção de segurança ajuda a evitar resultados não intencionais se a segurança do cliente de IA externo for comprometida.

3. Instalar o aplicativo MCP Standard Tools SuiteApp

Para usar o conector do NetSuite com o Breeze Assistant, instale o MCP Standard Tools SuiteApp. O SuiteApp permite consultar dados do NetSuite no Breeze Assistant usando linguagem natural.

O SuiteApp usa a função e as permissões existentes do NetSuite do usuário para determinar quais dados e ações ele pode acessar.

1. Faça login no NetSuite como administrador do NetSuite.
2. Clique na guia SuiteApps .
3. No campo Search SuiteApps , insira MCP Standard Tools.
4. Clique no ícone Ferramentas padrão do MCP .
5. No canto superior direito da página do SuiteApp, clique em Instalar.
6. Aguarde a conclusão da instalação.

4. Criar um registro de integração do OAuth 2.0

Crie um registro de integração no NetSuite para configurar a autenticação OAuth 2.0 entre o NetSuite e o HubSpot. Saiba mais na documentação do NetSuite.

1. No NetSuite, vá para Configurar > integração > Gerenciar integrações > Novo.
2. Insira um nome para a integração.
3. Defina o campo Estado como Ativado.
4. Na seção Escopos do OAuth 2.0 :

• • Marque a caixa de seleção Concessão de código de autorização .

• • Desmarque a caixa de seleção Cliente público . Um segredo do cliente é necessário para conectar o NetSuite ao HubSpot.
  • No campo URI de Redirecionar , insira o URI de redirecionamento do HubSpot. A URI deve usar https://oauth-redirect.hubspot.com/callback/netsuite_mcp.

• • Marque a caixa de seleção Serviço do conector de IA do NetSuite .
  • Desmarque as outras caixas de seleção do escopo do OAuth , incluindo RESTlets, Serviços da Web REST e SuiteAnalytics Connect.

5. Desmarque todas as caixas de seleção nas seções Autenticação baseada em token e Credenciais do cliente , incluindo a caixa de seleção Conceder credenciais do cliente (máquina a máquina).
6. Clique em Salvar.
7. Copie e armazene com segurança o ID do cliente e o segredo do cliente gerados.

Observação: o ID e o Segredo do cliente são exibidos somente depois que você salva o registro de integração pela primeira vez. Se você não salvar esses valores, precisará redefini-los no registro de integração para gerar novas credenciais.

5. Localize o URL do servidor NetSuite MCP

O URL do servidor MCP é específico da sua conta NetSuite e determina quais ferramentas estão disponíveis por meio da conexão.

Encontre seu ID de conta

1. No NetSuite, vá para Configurar > informações da empresa > e da empresa.
2. Localize o ID da conta na parte superior da página.
3. Clique na guia URLs da Empresa para revisar o URL do SuiteTalk específico da conta.

Configurar a URL do servidor MCP apropriada

• Para usar o MCP Standard Tools SuiteApp, use:
  https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/com.netsuite.mcpstandardtools
• Para expor todos os SuiteApps e projetos de personalização de conta disponíveis, use:
  https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/all
• Para expor um SuiteApp específico, use:
  https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/<publisherid>.<projectid>
• Substitua <accountid> pelo ID da sua conta do NetSuite.

Conectar o NetSuite ao Breeze Assistant

Depois que um administrador do NetSuite tiver configurado o conector no NetSuite, conecte o NetSuite ao Breeze Assistant. Tenha o URL do servidor NetSuite MCP, o ID do cliente e o segredo do cliente disponíveis antes de iniciar.

1. Na sua conta HubSpot, clique no ícone do Marketplace na barra de navegação superior e selecione HubSpot Marketplace.
2. Pesquise e selecione o NetSuite Connector.
3. Clique emInstalar.
4. Na caixa de diálogo:
   • No campo URL do servidor MCP do NetSuite , insira o URL do servidor MCP do NetSuite para sua conta do NetSuite.
   • No campo ID do cliente , insira a ID do cliente gerada a partir do registro de integração do NetSuite.
   • No campo Segredo do cliente , insira o Segredo do cliente gerado a partir do registro de integração do NetSuite.
5. Clique em Conectar para netsuite_mcp.

6. Você será redirecionado para NetSuite. Faça login usando uma função de não administrador com as permissões de MCP necessárias e autorize o HubSpot a acessar o NetSuite.
7. Após a autorização, você será redirecionado para o HubSpot e a conexão será estabelecida.

Usar o conector no Breeze Assistant

Depois de conectar, peça ao Breeze Assistant para recuperar informações ou concluir ações no NetSuite.

1. Na barra de navegação superior, clique em Breeze Assistant. 
2. Clique em + e navegue até Conectores.
3. Clique para ativar a opção Conector do NetSuite .
4. Em seguida, insira seu prompt.
   Por exemplo, você pode: 

• • Peça ao Breeze Assistant para mostrar os últimos 5 pedidos de vendas para uma empresa específica no NetSuite, incluindo itens de linha, valores e status atual.
  • Peça ao Breeze Assistant para mostrar todas as faturas em aberto com mais de 60 dias de atraso em todas as subsidiárias no NetSuite, classificadas por valor.
  • Peça ao Breeze Assistant para mostrar todos os pedidos de vendas criados esta semana no NetSuite que ainda estão com status de atendimento pendente.
  • Peça ao Breeze Assistant para comparar a receita total por subsidiária no NetSuite para o primeiro trimestre deste ano com o 2º trimestre deste ano.
  • Peça ao Breeze Assistant para mostrar a você todos os clientes em uma subsidiária específica no NetSuite que fizeram seu primeiro pedido no NetSuite nos últimos 6 meses.
  • Peça ao Breeze Assistant para fornecer um resumo completo da conta de uma empresa específica no NetSuite, incluindo todos os pedidos, faturas, pagamentos e problemas em aberto.

5. Clique no ícone Enviar no canto inferior direito.
6. O Breeze Assistant gerará uma resposta usando seus dados do NetSuite.