Prompts prontos para montar agentes e integrações

Leia https://docs.nextags.com.br/webhooks/visao-geral.md

Quero ligar a NexTags a [nome do sistema]. O que precisa acontecer: [descreva, por exemplo:
quando uma venda é aprovada na minha loja, o cliente recebe uma mensagem no WhatsApp e ganha
uma etiqueta]. Me diga qual das quatro formas usar (webhook de entrada, webhook de saída,
requisição externa ou API), por quê, e os passos na ordem, com o link da página de cada passo.

Leia https://docs.nextags.com.br/comecar/autenticacao.md e
https://docs.nextags.com.br/comecar/limites-e-erros.md. Use o contrato
https://docs.nextags.com.br/openapi.json como a lista oficial de endpoints.

Escreva em [linguagem e versão, por exemplo: Python 3.12 com requests] o código que
[descreva, por exemplo: acha o contato pelo e-mail e, se não existir, cria o contato
e manda o fluxo de boas-vindas]. Regras:
- a URL base é https://app.nextagsai.com.br/api;
- a chave vai no cabeçalho X-ACCESS-TOKEN e é lida da variável de ambiente NEXTAGS_API_KEY;
- o código roda no servidor, nunca no navegador;
- trate os erros de cada chamada e leia o corpo da resposta como JSON;
- use só endpoints que existem no openapi.json e diga o link da página de cada um.
Não peça a minha chave.

Leia https://docs.nextags.com.br/webhooks/webhook-de-entrada.md e
https://docs.nextags.com.br/webhooks/mapear-campos.md

Vou receber dados de [nome do sistema] num webhook de entrada da NexTags. Este é um exemplo do
JSON que ele envia, sem dados reais:
[cole o JSON]

Me devolva uma tabela com: o dado, o JSONPath (só com .chave, ["chave"] e [0], começando
com $), o campo da NexTags que recebe o valor e o tipo do campo (Texto, Número, Data, Data e hora,
Verdadeiro/Falso ou Texto longo). Diga qual caminho usar em Número de telefone e em Endereço de
e-mail, e se o telefone vem completo, com o código do país e o DDD.

Leia https://docs.nextags.com.br/webhooks/requisicao-externa-no-fluxo.md e
https://docs.nextags.com.br/comecar/mensagens-e-acoes.md

Escreva em [linguagem e framework] o endpoint que a External API Request de um fluxo da
NexTags vai chamar. Ele deve:
- conferir o cabeçalho X-Segredo com o valor da variável de ambiente NEXTAGS_SEGREDO,
  em tempo constante, e responder 401 se não bater;
- ler o cabeçalho X-USER-ID (o ID do contato) e o corpo em JSON: [descreva os campos];
- [descreva o que o servidor faz, por exemplo: consultar o pedido no meu banco];
- responder em JSON com "messages" e "actions": [descreva as mensagens, os botões e as ações].
Diga também o que preencher na External API Request: Request Type, Request URL, Cabeçalhos
e Corpo.

Leia https://docs.nextags.com.br/ia/respostas-do-agente-em-json.md e
https://help.nextags.com.br/tutoriais/ia/escrever-o-prompt.md

Vou configurar um agente de IA no AI Hub da NexTags. Meu negócio: [descreva].
Minhas mídias, cada uma com o link: [liste]. Os fluxos, etiquetas e campos que já existem:
[liste]. Quem recebe as conversas transferidas: [nome].

Escreva:
1. a Mensagem do sistema, com uma seção que diz quando usar texto, mídia, texto com botões e
   carrossel (sem pedir JSON no prompt);
2. as regras de Ações de IA, cada uma com o Quando e as ações na ordem;
3. um Prompt da ação curto;
4. os formatos que devo marcar em Tipo de resposta da IA.

Leia https://docs.nextags.com.br/comecar/autenticacao.md e
https://docs.nextags.com.br/comecar/limites-e-erros.md

Revise este código, que chama a API da NexTags:
[cole o código, sem a chave]

Procure, nesta ordem:
1. chave de API escrita no código, em arquivo versionado ou enviada ao navegador ou ao app
   (a chave deve vir de uma variável de ambiente do servidor);
2. link de webhook de entrada exposto no código do site;
3. URL base, caminhos e métodos diferentes do contrato https://docs.nextags.com.br/openapi.json;
4. falta de tratamento de erro, como a resposta 401 e chamadas sem tempo limite.
Para cada problema, mostre o trecho e a correção.