Os comandos internos são instruções que você escreve diretamente no prompt do agente para que ele execute ações dentro do Pingo Chat — como transferir atendimentos, adicionar tags, reagir a mensagens e muito mais. Este artigo mostra como estruturar essas instruções de forma correta e com exemplos práticos.
⚠️ Para que os comandos funcionem, a ferramenta correspondente precisa estar ativada na aba Ferramentas do agente. Comandos instruídos no prompt mas com ferramenta desativada serão ignorados.
Regra fundamental
O agente deve executar os comandos internamente e de forma transparente — o cliente nunca deve saber que um comando foi executado. Instrua sempre o agente a não mencionar os comandos, as transferências ou os processos internos na conversa.
❌ ERRADO no prompt:
"Diga ao cliente que vai executar o comando de transferência."
✅ CORRETO no prompt:
"Transfira o atendimento sem mencionar este processo ao cliente."Curtir mensagem
Comando: like_message
Use para que o agente reaja com um coração à mensagem do cliente — útil para confirmar recebimento ou sinalizar aprovação de forma humanizada.
Exemplo no prompt:
"Quando o cliente confirmar interesse em comprar, use like_message para reagir à mensagem."Executar comando — transferências e tags
Comando: execute_command
Este é o comando mais usado para transferências de fila, atribuição de atendentes e adição de tags. Os parâmetros são passados diretamente após o comando.
Sintaxe:
execute_command queueId:ID_DA_FILA userId:ID_DO_USUARIO tagId:ID_DA_TAGExemplos no prompt:
// Transferir para a fila de Vendas (ID 5):
"Se o cliente demonstrar interesse em comprar, execute internamente:
execute_command queueId:5
Não mencione a transferência ao cliente."
// Transferir para atendente específico (ID 1) e adicionar tag (ID 14):
"Ao identificar interesse em White Label, execute internamente:
execute_command queueId:5 userId:1 tagId:14
Continue a conversa normalmente."
// Apenas adicionar uma tag:
"Se o cliente mencionar suporte técnico, execute:
execute_command tagId:8"Para encontrar os IDs corretos de filas, usuários e tags da sua conta, consulte o artigo Ferramentas Disponíveis nos Agentes de IA — seção “Como encontrar os IDs”.
Chamar outro prompt
Comando: call_prompt_agent
Encadeia o agente atual com outro agente especialista. Útil quando o agente orquestrador identifica a intenção e precisa passar o atendimento para um subagente.
Exemplo no prompt:
"Se o cliente tiver dúvidas sobre suporte técnico, chame:
call_prompt_agent agente_suporte
Se for sobre vendas, chame:
call_prompt_agent agente_vendas"Ver e atualizar dados do contato
Comandos: get_contact_info e update_contact_info
// Consultar dados do contato:
"Antes de responder sobre o pedido, consulte get_contact_info para verificar os dados cadastrados."
// Atualizar um campo do contato:
"Quando o cliente informar o telefone, atualize com:
update_contact_info campo=telefone valor=NUMERO_INFORMADO"Enviar emoji
Comando: send_emoji
Exemplo no prompt:
"Ao encerrar o atendimento com sucesso, envie: send_emoji 😊"Segunda via de boleto/PIX
Comando: get_asaas_second_copy — requer ativação explícita (função sensível)
Exemplo no prompt:
"Se o cliente solicitar segunda via de boleto ou PIX, peça apenas o CPF.
Após receber, execute: get_asaas_second_copy com o CPF informado.
Apresente o resultado ao cliente sem mencionar o comando."Estrutura recomendada de prompt com comandos
Uma boa prática é criar uma seção dedicada aos comandos dentro do prompt, separada das regras de comportamento:
## 1. IDENTIDADE E PAPEL
Você é o assistente virtual da [Empresa]. Seu papel é...
## 2. REGRAS DE COMPORTAMENTO
- Nunca invente informações.
- Nunca mencione processos internos ao cliente.
- ...
## 3. AÇÕES INTERNAS (execute sem mencionar ao cliente)
- Cliente confirmou interesse em comprar → like_message → execute_command queueId:5 userId:1 tagId:14
- Cliente pediu suporte técnico → execute_command queueId:6 tagId:8
- Cliente pediu segunda via → peça o CPF → get_asaas_second_copy
## 4. PERFIL DA EMPRESA
Nome: [Empresa]
Setor: [Setor]
...Perguntas frequentes
O agente vai executar o comando sempre ou só quando a condição for atendida? O agente executa o comando quando a condição descrita no prompt for identificada na conversa. Instrua as condições com clareza para evitar execuções desnecessárias.
Posso combinar vários parâmetros no execute_command? Sim. Você pode passar queueId, userId e tagId juntos em um único comando: execute_command queueId:5 userId:1 tagId:14.
O agente pode executar mais de um comando em sequência? Sim. Instrua a sequência no prompt de forma clara, indicando a ordem das ações a serem executadas.
Como sei se o comando foi executado corretamente? Verifique na conversa se o ticket foi transferido, a tag foi aplicada ou a ação foi realizada conforme esperado. O agente não confirma a execução dos comandos na conversa — eles acontecem de forma transparente.