Guia de ajuda

O seu CRM, na conversa com o seu assistente.

Ligue o ChatGPT, o Claude ou o Codex para consultar contactos, negócios e tarefas sem sair da conversa.

Antes de começar

Peça à sua equipa que disponibilize a ligação ao CRM. Tenha consigo os dados de entrada no CRM e a aplicação autenticadora, se a utiliza.

Que assistente utiliza?

CodexVer passos

Estas instruções ligam o Codex instalado no seu computador ao CRM em produção. Confirme primeiro com a equipa que a ligação Codex está disponível.

Abra a configuração do Codex.
Com o Codex CLI instalado, abra o ficheiro ~/.codex/config.toml. No PowerShell do Windows:
```
notepad "$env:USERPROFILE/.codex/config.toml"
```
Adicione a configuração do CRM.
Se já existir uma entrada crm-vendas, atualize-a sem duplicar as secções. Preserve as restantes configurações e guarde o ficheiro.
```
[mcp_servers.crm-vendas]
url = "https://crmvendas.pt/api/mcp"

[mcp_servers.crm-vendas.oauth]
client_id = "9beb0b93-a2f2-4b38-b553-b7a6b2a26109"
callback_url = "http://127.0.0.1:8765/callback/wEuOeGAqA-FO"
callback_port = 8765
```
O Client ID identifica a ligação e é público. Cada pessoa autoriza o acesso com a sua própria conta.
Entre no CRM e autorize.
```
codex mcp login crm-vendas --scopes offline_access
```
Conclua a autorização no browser e o MFA, se solicitado. Depois abra uma nova sessão do Codex e experimente o pedido de consulta abaixo. No Codex CLI, pode consultar /mcp para verificar a ligação.

Erro de autorização ou porta ocupada

A porta 8765 tem de estar livre. Termine uma tentativa de login anterior antes de repetir. Se aparecer invalid_request, peça à equipa que confirme o callback desta configuração no registo OAuth. Não precisa de aceder ao painel de administração nem de registar um callback por utilizador.

ChatGPTVer passos

Abra o ChatGPT no browser.
Entre na conta onde pretende usar o CRM.
Escolha a ligação ao CRM.
Vá a Definições → Apps (Settings → Apps), procure o nome indicado pela sua equipa e inicie a ligação.
Entre no CRM e autorize.
Na página que abrir, entre na sua conta e autorize o assistente. Depois, numa nova conversa, selecione o CRM no menu de ferramentas ou escreva @ para o escolher.

Abrir o ChatGPT

Não encontro a ligação ao CRM

Peça à sua equipa que a disponibilize nesta conta. A opção depende do plano e das permissões do ChatGPT.

Se a equipa lhe pediu para a criar, use Apps → Create com Developer mode ativo. Introduza o endereço e o Client ID fornecidos, escolha OAuth, depois Scan Tools e Create. Se faltar alguma destas opções, contacte a equipa.

ClaudeVer passos

Abra o Claude no browser.
Entre na conta onde pretende usar o CRM.
Escolha a ligação ao CRM.
Vá a Customize → Connectors, procure a ligação indicada pela sua equipa e escolha Connect.
Entre no CRM e autorize.
Na página que abrir, entre na sua conta e autorize o assistente. Depois, na conversa, abra + → Connectors e ative o CRM.

Abrir o Claude

Não encontro a ligação ao CRM

Numa conta de equipa, peça ao proprietário que adicione a ligação. Numa conta individual, se tiver essa opção, escolha + → Add custom connector e introduza o endereço fornecido pela sua equipa.

Em Advanced settings, preencha OAuth Client ID com o identificador recebido. Deixe Client Secret vazio e escolha Add. Se lhe for exigido um segredo, contacte a equipa.

Já ligou? Experimente este pedido.

Consulta o CRM e indica a minha empresa e função, sem alterar dados.

Confirme que a resposta corresponde à sua conta. O assistente usa os seus acessos e também pode alterar dados quando o seu perfil o permite.

Precisa de ajuda?

É pedido um código de segurança

Use o código da sua aplicação autenticadora na página de autenticação do CRM. Se não for aceite, aguarde o seguinte. Nunca envie passwords ou códigos na conversa.

A ligação dá erro ou deixou de funcionar

Volte às definições do assistente e entre novamente na ligação ao CRM. Se continuar a falhar, indique à sua equipa o assistente e a mensagem de erro, sem enviar passwords, códigos ou o endereço completo da autorização.

Quero retirar o acesso ao CRM

Desligue a ligação nas definições do assistente e peça à sua equipa que revogue a autorização no CRM. Remover a ligação no assistente não confirma, por si só, a revogação do acesso.