---
title: Guia de instalação do aplicativo WeTransact HubSpot
slug: pt/guia-de-instalacao-do-aplicativo-wetransact-hubspot
icon: {"faIcon":"fa-brands fa-wordpress"}
createdAt: 2026-03-16T20:45:24.193Z
---

:::hint{type="danger"}
Este guia destina-se a administradores do HubSpot ou usuários técnicos responsáveis por configurar a integração do WeTransact com o HubSpot. Se você for um usuário de Vendas ou Marketing procurando criar negócios de Co-Sell ou Private Offers, consulte o[HubSpot - Criação de negócios de co-venda e ofertas privadas](https://docs.wetransact.io/pt/hubspot-criacao-de-negocios-de-co-venda-e-ofertas-privadas)
:::

## WeTransact para HubSpot: Guia de configuração

O aplicativo WeTransact para HubSpot permite que sua equipe de vendas registre private offers e negócios de co-sell da Microsoft a partir do registro de negócio do HubSpot no qual já estão trabalhando. Tudo o que um representante envia vai para o WeTransact e depois para o Microsoft Partner Center. Nada é gravado de volta no HubSpot, e o aplicativo não solicita permissões de gravação.

A configuração leva cerca de quinze minutos e possui três partes: conectar e instalar, adicionar os cards à visualização de negócios e verificar.

## Antes de começar

Você precisa de:

- Um tenant do WeTransact com o Microsoft Partner Center conectado e um login de **administrador** para ele.
- Pelo menos um plano publicado marcado como utilizável como modelo e pelo menos uma solução publicada nesse tenant. O assistente de Private Offer lista planos; o assistente de Co-Sell lista soluções.
- Uma conta HubSpot com Deals em uso e um usuário que seja **Superadministrador** nela. Instalar um aplicativo e editar a visualização do registro de negócio exigem isso.
- Estar conectado ao WeTransact e ao HubSpot no mesmo navegador.

Um tenant do WeTransact conecta-se a uma conta HubSpot. Se sua organização tiver várias contas HubSpot, decida primeiro qual delas sua equipe de vendas usa.

## 1. Conectar o HubSpot ao WeTransact

Comece pelo WeTransact, não pelo HubSpot Marketplace. O lado do WeTransact é o que vincula sua conta HubSpot ao seu tenant, para que os cards saibam qual catálogo e Partner Center usar. A mesma etapa instala o aplicativo.

1. Entre no WeTransact como administrador e vá para **Configurações → Integrações**.
2. Clique em **Conectar HubSpot**. Você será redirecionado ao HubSpot. Se pertencer a mais de uma conta HubSpot, escolha aquela que sua equipe de vendas usa.
3. Revise o acesso solicitado. O aplicativo solicita acesso de leitura a negócios, contatos e empresas e, opcionalmente, à configuração de moeda da sua conta. Ele não solicita acesso de gravação. Conceda o acesso.
4. Você retornará ao WeTransact. O HubSpot agora aparece como conectado, junto com o ID do portal HubSpot ao qual está vinculado. Mantenha esse ID à mão; ele aparece nos cards e é o que o suporte solicitará.
5. No HubSpot, **Configurações → Integrações → Aplicativos conectados** agora lista **Aplicativo WeTransact HubSpot**. Não há nada para configurar ali.

:::BlockQuote
**Instalado primeiro pelo Marketplace?** O aplicativo está instalado, mas ainda não está vinculado a um tenant, e os cards mostram *O WeTransact não está conectado* com o ID do seu portal. Conclua as etapas 1 a 4 acima. A instalação existente será reutilizada.
:::

## 2. Adicionar os cards aos registros de negócio

O aplicativo fornece dois cards para registros de negócio: **Oferta privada WeTransact** e **Co-venda WeTransact**. O HubSpot não posiciona cards de aplicativos automaticamente; um Super Admin os adiciona à visualização de negócios uma vez, e então todos os usuários dessa visualização passam a vê-los.

1. No HubSpot, vá para **Configurações → Objetos → Negócios → Personalização de registros** e abra a visualização que sua equipe usa, normalmente a visualização padrão.
2. Na seção da barra lateral direita, adicione um card, filtre pelo aplicativo WeTransact e adicione **Oferta privada WeTransact** e **Co-venda WeTransact**. Arraste-os para perto do topo para que os representantes não precisem rolar a tela.
3. Salve a visualização. Se suas equipes usarem visualizações de negócios diferentes, repita para cada visualização que deve ter os cards.

Abra qualquer negócio. Ambos os cards aparecem na barra lateral direita, primeiro mostrando *Verificando sua conexão com o WeTransact…* e depois seus botões:

- **Abrir interface do WeTransact** abre seu dashboard do WeTransact em uma nova aba.
- **Recarregar** atualiza esse link caso ele não tenha carregado.
- **Iniciar oferta privada** / **Iniciar co-venda** abre o assistente.

## 3. Verificar

1. **Conexão.** Abra um negócio. Cada card mostra seus botões em poucos segundos. Se mostrar *O WeTransact não está conectado*, volte para a parte 1.
2. **Link do dashboard.** Clique em **Abrir interface do WeTransact**. Seu dashboard do WeTransact é aberto, conectado ao tenant que você conectou.
3. **Catálogo.** Clique em **Iniciar oferta privada**. Na etapa 1, a lista Products mostra seus planos publicados. Clique em **Cancelar** e confirme; nada foi criado.
4. **Preenchimento automático.** Em um negócio que tenha nome, valor e um contato principal, inicie a Private Offer novamente: Offer Name e o primeiro email do assinante são preenchidos automaticamente. Cancele novamente.
5. **Uma execução real, apenas com um sandbox.** Se sua conexão do Partner Center for um sandbox, execute o assistente até o final. Caso contrário, pare aqui: uma Private Offer concluída é uma oferta real publicada para a Microsoft.

Seus representantes agora podem usar ambos os assistentes. Direcione-os para o Manual do Usuário.

## O que os cards fazem

### Registrar uma oferta privada a partir de um negócio

Clique em **Iniciar oferta privada** em um negócio. São cinco etapas; os campos que o negócio já responde são preenchidos automaticamente e podem ser alterados.

1. **Detalhes da oferta e produtos.** Offer Name (do nome do negócio), Billing ID, Prepared By (seu email), mês de início e término da oferta ou início na aceitação, Offer Valid Until Date, Publisher Location e os produtos e planos publicados nos quais esta oferta se baseia. Até dez planos.
2. **Assinantes.** Endereços de email dos contatos do cliente que recebem a oferta. O contato principal do negócio é preenchido automaticamente. Até cinco, adicionados um de cada vez.
3. **Preços por plano.** Para cada plano selecionado: prazo do contrato, intervalo de cobrança, moeda e preço, preenchidos automaticamente a partir do modelo do plano. Opcionalmente, moedas secundárias, um cronograma de cobrança com datas, dimensões personalizadas com quantidade incluída e preço excedente, e usuários mínimos ou máximos quando o plano permitir.
4. **Termos e condições personalizados.** Cole a URL dos seus termos ou faça upload de um PDF e cole a URL fornecida. Opcional.
5. **Pronto para publicar.** Marque **Pronto para publicar**, depois **Concluir**. A oferta é criada no WeTransact e publicada para a Microsoft.

Gerencie a oferta posteriormente no WeTransact, por meio de **Abrir interface do WeTransact**.

### Registrar um negócio de co-sell a partir de um negócio

Clique em **Iniciar co-venda** em um negócio. São seis etapas, seguidas de uma confirmação.

1. **Encontrar o cliente Microsoft.** Nome e país do cliente, preenchidos automaticamente a partir da empresa associada ao negócio. **Próximo** busca todos os clientes Microsoft correspondentes.
2. **Selecionar o cliente.** Escolha um da lista. A filtragem acontece localmente.
3. **Detalhes do negócio.** Deal Name, Estimated Value, Currency e Estimated Closing Date (preenchidos automaticamente a partir do negócio), Your CRM ID (preenchido automaticamente com um link para este negócio do HubSpot), Your Campaign ID, Organization, Solution Area, Conversation e Notes.
4. **Membros da equipe.** Selecione membros existentes da equipe ou adicione novos com nome, telefone e email. Pelo menos um.
5. **Soluções.** Selecione pelo menos uma das suas soluções publicadas.
6. **Envolvimento da Microsoft e envio.** Escolha o nível de envolvimento da Microsoft, nomeie o contato principal do cliente e depois **Enviar**.
7. **Confirmação.** *Negócio enviado* confirma que a Microsoft aceitou o registro.

## O que os cards leem do HubSpot

Cada card lê um conjunto fixo de propriedades do negócio no qual é aberto, apenas para preencher automaticamente o assistente. Nada é armazenado e nada é gravado.

| Ler de                       | Propriedade                                       | Usado para                                                                                     |
| ---------------------------- | ------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Negócio                      | Nome do negócio, valor, moeda, data de fechamento | Nome da oferta; Nome do negócio de co-sell, valor estimado, moeda, data estimada de fechamento |
| Contato principal do negócio | Email                                             | Primeiro assinante da oferta privada                                                           |
| Empresa associada ao negócio | Nome, país                                        | Pesquisa de cliente de co-sell                                                                 |
| Conta                        | Moeda padrão (escopo opcional)                    | Moeda de co-sell quando o negócio não possui uma                                               |
| Você                         | Seu usuário do HubSpot                            | Prepared By na oferta privada                                                                  |

## Permissões

O aplicativo usa OAuth do HubSpot e solicita:

- `crm.objects.deals.read`, `crm.objects.contacts.read`, `crm.objects.companies.read`: ler o negócio, seu contato principal e a empresa associada para preenchimento automático.
- `settings.currencies.read` (opcional): a moeda padrão da sua conta como alternativa para negócios de co-sell.

Sem escopos de gravação. Os dados que um representante insere são enviados por HTTPS ao conector de CRM da WeTransact em `crmproxy.wetransact.io`, que atua no Microsoft Partner Center com as credenciais do próprio tenant. O HubSpot assina cada solicitação do cartão para que o conector possa verificar de qual conta ela veio.

## Solução de problemas

| Você vê                                                  | Causa                                                                                                  | Correção                                                                                                                       |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| *WeTransact não está conectado*                          | Esta conta do HubSpot não está vinculada a um tenant do WeTransact.                                    | Um administrador do WeTransact clica em Connect HubSpot em Settings → Integrations. Depois, **Verifique novamente** no cartão. |
| *Não foi possível acessar o WeTransact*                  | Um problema de rede ou serviço, não um problema de configuração.                                       | Clique em **Tentar novamente**. Se persistir, entre em contato com o suporte com o ID do portal mostrado no cartão.            |
| Cartões ausentes em negócios                             | Os cartões do aplicativo não são posicionados automaticamente ou o usuário está em outra visualização. | Parte 2 acima.                                                                                                                 |
| Cartões ausentes em contatos ou empresas                 | Por design; os cartões são apenas para negócios.                                                       | Abra o negócio.                                                                                                                |
| A lista de produtos ou soluções está vazia               | Nenhum plano ou solução publicado utilizável no tenant conectado.                                      | Publique o plano e habilite-o como modelo, ou publique uma solução, no WeTransact.                                             |
| **Abrir interface do WeTransact** permanece desabilitado | O link do dashboard falhou ao carregar.                                                                | Clique em **Recarregar**.                                                                                                      |

## Desconectar ou desinstalar

Duas ações independentes; faça ambas para remover a integração completamente.

1. No WeTransact, **Configurações → Integrações**, remova a conexão do HubSpot. Os cartões mostram imediatamente *WeTransact não está conectado*.
2. No HubSpot, **Configurações → Integrações → Aplicativos conectados**, abra o WeTransact HubSpot App e desinstale-o. Isso revoga o acesso e remove os cartões de todas as visualizações.

Ofertas e registros já criados permanecem no WeTransact e no Microsoft Partner Center.

## Suporte

[support@wetransact.io](mailto\:support@wetransact.io). Inclua o ID do portal do HubSpot mostrado no cartão.
