Atalhos para o ChatGPT e o Claude

Passo 1: Abra a página na IA

No topo da página, clique na seta ao lado de Copiar página e escolha Abrir no ChatGPT ou Abrir no Claude. A conversa abre com este pedido, já com o endereço do .md da página:

Leia https://docs.nextags.com.br/webhooks/webhook-de-entrada.md e me ajude a usar a NexTags com base nesta página.

Continue a conversa com a sua dúvida. Se a IA disser que não consegue abrir o endereço, use Copiar página e cole o texto na conversa: ele vai em Markdown, com os links completos.

Passo 2: Use o pedido pronto da página

Os guias terminam com o bloco Faça com a IA: um pedido pronto, que cita o .md da página e tem lacunas entre colchetes para você completar. Clique em Copiar pedido, cole na conversa e troque o que está entre colchetes, como neste pedido do guia do webhook de entrada:

Vou mandar dados do meu sistema para um webhook de entrada da NexTags. Leia este guia: https://docs.nextags.com.br/webhooks/webhook-de-entrada.md

Este é um exemplo do JSON que o meu sistema envia, sem dados reais: [cole aqui]. ...

Mais pedidos, para outras tarefas, estão em Prompts prontos para montar agentes e integrações.

Passo 3: Monte um projeto com a documentação

Para conversar sobre a NexTags em vários dias, crie um projeto no ChatGPT ou no Claude e ponha a documentação como arquivos do projeto. Baixe três arquivos: o llms-full.txt das duas centrais e o contrato da API.

curl -o docs-llms-full.txt https://docs.nextags.com.br/llms-full.txt
curl -o ajuda-llms-full.txt https://help.nextags.com.br/llms-full.txt
curl -o openapi.json https://docs.nextags.com.br/openapi.json

Invoke-WebRequest https://docs.nextags.com.br/llms-full.txt -OutFile docs-llms-full.txt
Invoke-WebRequest https://help.nextags.com.br/llms-full.txt -OutFile ajuda-llms-full.txt
Invoke-WebRequest https://docs.nextags.com.br/openapi.json -OutFile openapi.json

Depois:

• No ChatGPT: crie um projeto e adicione os arquivos como fontes do projeto. As instruções do projeto ficam nas configurações dele. Veja Projects in ChatGPT, da OpenAI.
• No Claude: em Projects, crie um projeto (+ New Project), envie os arquivos pelo + do conhecimento do projeto e escreva as instruções em Set project instructions. Veja How can I create and manage projects?, da Anthropic.

Nas instruções do projeto, diga como você quer as respostas:

Você me ajuda a integrar sistemas com a NexTags. Use os arquivos deste projeto como fonte:
docs-llms-full.txt (central de desenvolvedores), ajuda-llms-full.txt (Central de Ajuda)
e openapi.json (o contrato da API).
Responda em português. Nos exemplos de código, use a URL base https://app.nextagsai.com.br/api
e a chave no cabeçalho X-ACCESS-TOKEN, lida da variável de ambiente NEXTAGS_API_KEY.
Use só endpoints que existem no openapi.json. Se a documentação não disser algo, diga que não
está documentado, em vez de supor.

Passo 4: Peça o código da integração

Descreva o que o seu sistema precisa fazer, a linguagem e onde o código vai rodar. Peça que a chave venha de uma variável de ambiente:

Quero criar o contato na NexTags e mandar o fluxo de boas-vindas quando alguém se cadastra
no meu site. Meu servidor é Node 20. Escreva o código com fetch, lendo a chave de
process.env.NEXTAGS_API_KEY, e trate os erros de cada chamada. Diga quais endpoints usou
e o link da página de cada um.

Confira os endpoints da resposta na Referência da API e rode o código primeiro numa conta de testes ou com o seu próprio contato.

Passo 5: Deixe a chave fora da conversa

A IA não precisa da sua chave para escrever o código, e uma chave colada numa conversa fica guardada no histórico. Guarde a chave numa variável de ambiente, no terminal ou no servidor, e use o código que a lê de lá:

# macOS e Linux
export NEXTAGS_API_KEY="SUA_CHAVE_DE_API"

# Windows (PowerShell)
$env:NEXTAGS_API_KEY = "SUA_CHAVE_DE_API"

Troque SUA_CHAVE_DE_API pela chave, só no seu terminal. A chamada sai do servidor, nunca do navegador nem do app do celular: lá, a chave ficaria exposta. Para conferir a chave, veja Sua primeira requisição.