Skip to main content
Endpoint · POST /conversation/actions
ai_assistance executa o funcionário AI que você escolher sobre a conversa sem atribuí-lo. É uma execução pontual: o funcionário roda de forma transitória e gera sua assistência (contexto/sugestão) sobre a conversa, mas não se torna o funcionário atribuído — a conversa continua com quem a atende (outro funcionário AI ou um humano) e a atribuição não muda. Como se diferencia das outras ações de AI:
  • run_ai executa o funcionário atribuído —o que atende— e assume o turno.
  • assign_ai_employee muda qual funcionário atende a conversa.
  • ai_assistance executa outro funcionário sem atribuí-lo — sua saída não muda quem atende.
Campos
  • ai_employee — { name } do funcionário AI a consultar (obrigatório).
  • instructions — texto opcional com a consulta ou o foco para o funcionário (por exemplo, “Este cliente se qualifica para o plano empresarial?”).
Consome tokens do modelo do funcionário consultado e conta como ação que dispara AI (máximo 3 por grupo). Em uma lista, este objeto vai no array actions de um POST /conversation/actions — veja Montar uma lista de ações.

​
Exemplo executável

Um ai_assistance em uma conversa identificada por telefone e canal: executa de forma pontual o funcionário AI escolhido, sem mudar a atribuição da conversa.

​
Request

​
Resposta

202 Accepted — o grupo foi aceito e roda em background. O resultado por ação não viaja na resposta (consulte-o depois — veja Como é executado).
​
string
Sempre processing: confirma que o grupo foi aceito e está em execução.
​
integer
Quantas ações do array foram admitidas para execução — não quantas tiveram sucesso.