A Inngage possui integração nativa com a plataforma de e-commerce VTEX, permitindo a listagem de pedidos e clientes. Para habilitá-la, você precisa criar uma credencial de API na VTEX que será utilizada pela Inngage.
Parte 1: criar a API Key na VTEX
- Acesse sua conta VTEX com o usuário master.
- No menu, procure por Segurança e clique em Gerar appKey e appToken.
- Insira uma descrição para a chave (ex.: "Inngage CRM").
- Clique em Gerar novos tokens.
- O token será exibido uma única vez — copie e guarde para usar na Inngage.
Consulte a documentação da VTEX para mais detalhes sobre a criação de chaves de API.
Parte 2: definir as permissões na VTEX
Por padrão, credenciais de API são geradas sem nenhuma permissão. É preciso associar a chave a perfis de acesso:
- Na seção Segurança, copie a chave de API (appKey) exibida na coluna "Chave de acesso".
- Acesse Gestão de contas → Usuários.
- Localize a chave de acesso copiada.
- Atribua os perfis com os recursos abaixo, conforme as entidades que serão integradas:
| Produto | Recursos necessários |
|---|---|
| Catalog (Produtos) | Collection — Read Collections |
| OMS (Pedidos e clientes) | OMS Access: View order · Order feed subscription · Feed v3 and Hook view only · Subscription view only |
| Master Data (Contatos) | Generic resources — Read-only form access |
| Dynamic Storage (Contatos) | Read only documents · List/View data entity · List/View triggers |
Consulte a documentação de Perfis de Acesso da VTEX para detalhes.
Parte 3: ativar a integração na Inngage
- Na plataforma Inngage, vá até App Store e escolha VTEX.
- Preencha as credenciais e parâmetros:
- Chave de API (appKey)
- Token (appToken)
- Nome da conta (accountName)
- Ambiente (
vtexcommercestableouvtexcommercebeta)
Em caso de dúvida sobre os parâmetros, fale com o seu executivo de contas.
