IA (ChatGPT)

Com a API, uma IA pode trabalhar dentro do seu CRM: consultar listas, criar leads, preparar uma campanha de e-mail. Este artigo mostra como ligar o ChatGPT ao CRM criando um GPT personalizado, um assistente seu, com as “Ações” (em inglês, Actions) conectadas à API.

Antes de começar

• Você precisa de uma conta paga do ChatGPT. Criar GPTs personalizados não está disponível na conta gratuita.
• Crie uma chave de API no CRM. Veja Chaves de API. Escolha uma chave com validade, e Somente leitura se o assistente só vai consultar.

A chave fica guardada dentro do GPT

Quem usar o seu GPT age no CRM com a sua chave. Por isso:

• Use uma chave com vencimento (de 7 ou 30 dias, por exemplo), e não uma sem expiração.
• Ao salvar o GPT, compartilhe como Somente eu (em inglês, Only me). Nunca deixe público nem “qualquer pessoa com o link”.
• Se tiver qualquer dúvida de quem teve acesso, revogue a chave e crie outra. Quem estiver usando a chave perde o acesso na hora.

Criar o GPT

Os nomes dos botões abaixo estão em português, com o nome em inglês entre parênteses na primeira vez. O ChatGPT pode mostrar a tela em inglês, e os nomes podem variar um pouco de uma versão para outra.

1. Abra a criação de GPTs. No ChatGPT, clique em Explorar GPTs (Explore GPTs), no menu lateral.

2. Clique em Criar. Clique em Criar (Create), no canto superior direito.

3. Abra a aba Configurar. Clique na aba Configurar (Configure). É a aba em que você preenche os campos à mão.

4. Dê um nome ao GPT. No campo Nome (Name), escreva, por exemplo, Assistente do CRM Datta.

5. Cole as instruções. No campo Instruções (Instructions), cole o texto da seção Instruções sugeridas logo abaixo.

6. Crie a ação. Role até Ações (Actions) e clique em Criar nova ação (Create new action).

7. Importe o esquema da API. Clique em Importar do URL (Import from URL), cole o endereço abaixo e clique em Importar (Import):

   https://dattacrm.com.br/api/v1/openapi.json

8. Abra a autenticação. Em Autenticação (Authentication), clique na engrenagem.

9. Escolha o tipo de autenticação. Selecione Chave de API (API Key). Em Tipo de autenticação (Auth Type), selecione Bearer.

10. Cole a chave. No campo Chave de API (API Key), cole a chave que você copiou do CRM (ela começa com crm_live_) e clique em Salvar (Save).

11. Salve o GPT como privado. Clique em Criar (Create) ou Salvar (Save), no canto superior direito. Na hora de salvar ou em Compartilhar (Share), escolha Somente eu (Only me). Se aparecerem só opções como Qualquer pessoa com o link ou GPT Store, não confirme: volte e escolha Somente eu.

O esquema que você importou é a lista de tudo o que a API faz. É por ele que o GPT sabe quais pedidos pode fazer ao CRM.

Instruções sugeridas

Estas instruções deixam o GPT mais seguro. Cole e adapte ao seu jeito de trabalhar:

Você ajuda a equipe a trabalhar no Datta CRM usando a API.

Regras:
- Sempre crie campanhas de e-mail como rascunho. Nunca diga que enviou ou agendou um e-mail: a API não envia nem agenda.
- Se não ficar claro qual lista deve receber a campanha, consulte as listas da conta e pergunte qual usar.
- Antes de criar ou alterar qualquer coisa, resuma o que vai fazer e peça a minha confirmação.
- Depois de criar um rascunho, mostre o link para abri-lo no CRM (editUrl) e lembre que preciso revisar, testar e agendar por lá.
- Responda sempre em português do Brasil.

Um exemplo de pedido

Depois de salvar, abra o GPT e escreva, por exemplo:

Crie um rascunho de campanha para a lista Clientes com este HTML, para sexta às 10h.

E cole o HTML do e-mail na mesma mensagem. O que acontece:

1. O GPT consulta as listas do CRM e acha a lista Clientes.
2. Ele resume o que vai fazer e pede a sua confirmação, como você deixou nas instruções.
3. Depois do seu “pode criar”, ele cria o rascunho da campanha, ligado à lista Clientes, com o horário de sexta às 10h guardado como horário sugerido (no campo desiredSendAt).
4. Ele mostra o link do rascunho (editUrl) e quantos leads receberiam o e-mail hoje.

Peça o horário com data completa se houver dúvida

“Sexta às 10h” depende do dia de hoje e do fuso horário. Confira no resumo que o GPT mostrar se a data e o horário estão certos antes de confirmar.

O rascunho continua sendo seu

Pela API, o GPT nunca envia nem agenda e-mail. O rascunho fica no CRM como rascunho, esperando uma pessoa. Quem decide é você:

1. Abra o rascunho no CRM. Clique no link que o GPT mostrou (o editUrl) ou abra o menu E-mail e procure a campanha.

2. Revise o conteúdo. Confira assunto, texto, listas e o visual do e-mail.

3. Envie um teste. Faça um envio de teste para você mesmo, como em Campanhas.

4. Agende o envio. Clique para agendar. A janela abre já preenchida com o horário que o GPT sugeriu, marcado como Envio sugerido. Confirme ou troque.

Se o ChatGPT não aceitar a importação

O esquema da API tem 27 operações. Ainda não testamos a importação completa dele em um GPT de verdade, e o ChatGPT tem limites próprios para ações. Se ele recusar a importação ou mostrar uma mensagem de erro, copie a mensagem exatamente como aparece e envie ao suporte. Assim conseguimos ver o que precisa ser ajustado.

Próximo passo

Próximo passo Erros comuns Entenda cada código de erro da API e como resolver.