Ferramentas Disponíveis nos Agentes de IA
Ao configurar um Agente de IA no Pingo Chat, você pode ativar ferramentas específicas que ampliam as capacidades do seu agente. Cada ferramenta executa uma função diferente e pode ser habilitada ou desabilitada individualmente.
Para acessar as ferramentas, vá em Automações → Agentes de IA, clique em editar um agente e acesse a aba Ferramentas.
Curtir mensagem
Comando: like_message
Reage à mensagem do cliente com um emoji de coração. Útil para confirmar recebimento ou demonstrar aprovação de forma natural e humanizada.
Comando simples:
like_message
Ativa por padrão neste agente.
Enviar emoji
Comando: send_emoji
Responde rapidamente com emojis pré-definidos para tornar a conversa mais humanizada.
Diga:
send_emoji 😀
Ativa por padrão neste agente.
Formatar mensagem
Comando: format_message
Aplica variáveis e formatação avançada nas mensagens enviadas pelo agente.
Use:
format_message {{ms}}, {{name}}!
Ativa por padrão neste agente.
Ver dados do contato
Comando: get_contact_info
Retorna informações armazenadas no cadastro do cliente, como nome, telefone e outros campos.
Instrua:
get_contact_info
Atualizar contato
Comando: update_contact_info
Edita campos do cadastro do contato diretamente pela conversa.
Instrua:
update_contact_info campo=telefone valor=55999999999
Enviar produto
Comando: send_product
Envia cards de produtos cadastrados diretamente na conversa.
Diga:
send_productcom o código do produto. Ex: PROD-123.
Enviar arquivo do contato
Comando: send_contact_file
Compartilha arquivos armazenados no cadastro do contato.
Peça:
send_contact_fileenviando o contrato.
Horário da empresa
Comando: get_company_schedule
Consulta o horário de funcionamento cadastrado no sistema e informa ao cliente automaticamente.
Pergunte:
get_company_schedule
Listar profissionais
Comando: list_professionals
Consulta os profissionais e horários disponíveis cadastrados no sistema.
Comando:
list_professionals
Chamar outro prompt
Comando: call_prompt_agent
Encadeia prompts diferentes como sub-agentes, permitindo criar fluxos mais complexos de atendimento.
Fale:
call_prompt_agent vendedor_pro
Executar comando
Comando: execute_command
Executa transferências para filas, atribuições a atendentes e adição de tags. Os parâmetros são passados diretamente após o comando.
Sintaxe:
execute_command queueId:5 userId:1Exemplos de uso:
| Ação | Comando |
|---|---|
| Transferir para uma fila/departamento | execute_command queueId:ID_DA_FILA |
| Transferir para um atendente | execute_command userId:ID_DO_USUARIO |
| Adicionar uma tag | execute_command tagId:ID_DA_TAG |
| Combinado (fila + atendente + tag) | execute_command queueId:2 userId:63 tagId:68 |
⚠️ Nunca mencione este comando ao cliente. O agente deve executá-lo internamente, de forma completamente transparente.
Executar integração externa
Comando: execute_tool
Acessa ferramentas conectadas por APIs externas.
Instrua: Chame
execute_toolusando o conector cobrança.
⚠️ Função sensível. Fica desabilitada por padrão e deve ser ativada explicitamente nas configurações do agente.
Segunda via Asaas
Comando: get_asaas_second_copy
Consulta boleto ou PIX diretamente no Asaas usando apenas o CPF do cliente.
Use
get_asaas_second_copycom o CPF informado pelo cliente.
⚠️ Função sensível. Fica desabilitada por padrão e deve ser ativada explicitamente nas configurações do agente.
Como encontrar os IDs para usar no execute_command
Os IDs de tags, departamentos e usuários não são fixos — cada conta Pingo Chat tem os seus próprios. Consulte sempre o painel antes de configurar o prompt do agente.
IDs de Tags
Acesse Atendimento → Tags. A coluna ID mostra o número de cada etiqueta.
Exemplo: a tag White Label aparece com ID #14, a tag Cliente White Label com ID #68.
execute_command tagId:14IDs de Departamentos (Filas)
Acesse Atendimento → Departamentos. A coluna ID mostra o número de cada fila.
Exemplo: o departamento Comercial aparece com ID #2, o Suporte com ID #3, o Financeiro com ID #4.
execute_command queueId:2IDs de Usuários (Atendentes)
Acesse Configurações → Usuários. A coluna ID mostra o número de cada atendente.
Exemplo: o usuário Henrique Hoinacki aparece com ID #63, o usuário Meta Support com ID #73.
execute_command userId:63Como usar as ferramentas no prompt
- Ative a ferramenta na aba Ferramentas do agente.
- Consulte os IDs de tags, departamentos e usuários diretamente no painel conforme explicado acima.
- Instrua o agente no prompt usando o comando exato com os IDs corretos da sua conta.
- Nunca mencione os comandos ao cliente — o agente deve executá-los internamente de forma transparente.
Exemplo prático no prompt:
Se o cliente sinalizar interesse em compra, use like_message para reagir.
Em seguida, execute: execute_command queueId:2 userId:63 tagId:68
Não mencione este processo ao cliente.