Handoff
The Handoff screen is for seeing who is waiting for a human, understanding why the AI passed the conversation and handing it to an agent who comes in already knowing what the lead said.
Address in the dashboard: /app/handoff
How to get there: Through the Handoff menu item, under "OPERAÇÃO" (OPERATIONS). The screen subtitle says "Transbordo humano estruturado" (Structured human handoff).
Queue numbers
Four cards at the top, all read-only.
Fields and filters
- Handoff accuracy
- The percentage of times the team agreed with the AI's qualification, based on the "Concordo" (Agree) and "Discordo" (Disagree) votes given in the Inbox dossier. Below, how many evaluations exist, or "sem feedback ainda" (no feedback yet).
- "Na fila agora" (In queue now)
- How many conversations are waiting for a human right now. If the queue cannot be read, it shows a dash and "não foi possível contar" (could not count), never zero.
- "Tempo médio aguardando" (Average wait time)
- The average wait of the conversations that are in the queue right now, in short format (minutes, hours or days).
- "Satisfação (CSAT)" (Satisfaction (CSAT))
- The average of the 1-to-5 ratings given by leads after service and how many ratings exist, or "sem notas ainda" (no ratings yet).
Buttons and actions
- "por atendente" (per agent)
- Pill on the satisfaction card: on hover, it shows each agent's average and number of ratings. Only appears when there are already ratings per agent.
Handoff queue
The list on the left: one row per conversation waiting for a human or already in human service.
Buttons and actions
- ‹lead›
- Clicking a row opens that lead's dossier beside it. The first conversation in the queue is already open.
- The lead's avatar and name, with the wait time on the right.
- The handoff reason (for example, the lead asked for a person, the order was complete, or "Possível robô do outro lado" (Possible bot on the other end), when the AI stopped to avoid looping with an automatic reply); with no reason recorded, "Transbordo solicitado" (Handoff requested), or "Em atendimento humano" (With a human agent) when someone has already taken over.
- The score band with the number ("Quente" (Hot), "Morno" (Warm), "Frio" (Cold) or "Sem score" (No score)).
- The selected row is highlighted with a side bar.
Header of the selected lead
Who the lead is, how they arrived and their score.
- Name, company or phone and the conversation channel.
- The score band with the number.
LEAD DOSSIER: opening
The first lines of the dossier say why the conversation is here and for how long.
- Badge "Esperando há ‹tempo›" (Waiting for ‹time›) when the conversation is waiting for a human.
- "Por que veio para um humano:" (Why it came to a human:) followed by the handoff reason.
- Without a handoff: "Sem transbordo: ‹nome› está com a conversa, e a IA não responde por cima." (No handoff: ‹name› has the conversation, and the AI does not reply over them.), "Esta conversa ainda não foi transbordada — a IA segue conduzindo." (This conversation has not been handed off yet — the AI keeps leading.) or the notice that the AI is silent in that conversation and until when.
- Total messages since the conversation began and the lead's "humor do lead" (mood) measured by the AI (hover to see when it was measured).
WHAT THE AI HAS ALREADY AGREED
The summary of this conversation written by the AI at the moment of the handoff.
- AI text, without quotation marks, with "Próximo passo sugerido:" (Suggested next step:) and the signature "Resumo da IA · ‹data›" (AI summary · ‹date›).
- Only valid for this conversation: what was agreed in earlier conversations with the same lead is left out.
- With no handoff yet, the block explains that the summary is created at the handoff. With a handoff and no summary, it says the AI does not write one when it cannot read the conversation in time.
WHERE THEY GOT STUCK
The lead's objections across all of their conversations.
- The objection type (AI classification), the date and, in quotation marks, the lead's literal sentence.
- An objection from another conversation carries the label "de uma conversa anterior" (from a previous conversation).
- When the list is long, the line "Mostrando as ‹n› mais recentes de ‹total›." (Showing the ‹n› most recent of ‹total›.) notes the cutoff.
- Sentence removed at the data subject's request (LGPD): the objection stays listed, without the quote.
- With no objections: "Nenhuma objeção registrada para este lead — em conversa nenhuma." (No objection recorded for this lead — in any conversation.)
HOW THE SCORE CHANGED
The history of the lead's score and the signals the AI has already captured.
- Line chart with the score measurements and the warm (50) and hot (75) boundaries marked. Hover over a point to see the date and score.
- Summary sentence: "Subiu" (Rose), "Caiu" (Fell) or "Estável em ‹nota›" (Stable at ‹score›) since the first measurement shown.
- With a single measurement, the score number appears instead of the chart, with the measurement date.
- Each signal that "Qualificação" (Qualification) asks for appears with "capturado" (captured) or "ainda não" (not yet) and, when captured, the sentence of what the AI understood, marked "como a IA entendeu" (as the AI understood it).
CONVERSATION PACE
Messages per day over the last 14 days.
- Separate bars for Lead and "Nosso lado" (Our side), with the totals in the legend. A day with no messages stays empty.
- Below, "A última coisa que ele disse, em ‹data›" (The last thing they said, on ‹date›), with the lead's sentence.
FIT WITH THE IDEAL CUSTOMER
Only appears when the account has described the ideal customer in "Configurações" (Settings).
- A ring from 0 to 100 and the sentence on how the AI compared the lead with the profile, with the evaluation date.
WHAT THE AI KEPT ABOUT THIS LEAD
The memory the AI writes for itself across all of the lead's conversations.
- AI text with the signature "Memória da IA · atualizada em ‹data›" (AI memory · updated on ‹date›).
TEAM NOTES
The only part of the dossier written by the team; it stays attached to the lead, even in new conversations.
Fields and filters
- "O que o próximo atendente precisa saber?" (What does the next agent need to know?)
- The note text. Ctrl + Enter saves; near the character limit, the counter shows how many are left.
Buttons and actions
- "Anotar" (Add note)
- Saves the note with the name of whoever wrote it and the date.
- "Remover a anotação de ‹autor›" (Remove ‹author›'s note)
- The trash can on each note opens the confirmation "Remover esta anotação?" (Remove this note?).
- With no notes: "Ninguém anotou nada sobre este lead ainda." (Nobody has noted anything about this lead yet.)
- If saving fails, the text stays in the field with the notice "Não foi possível salvar a anotação." (The note could not be saved.)
Confirmation: Remove this note?
Shows who wrote it and the text. The rest of the dossier does not change, and the removal cannot be undone.
Buttons and actions
- "Remover anotação" (Remove note)
- Deletes the note.
- "Cancelar" (Cancel)
- Keeps the note.
Taking over the conversation
The dossier footer, with the reminder "Ao assumir, o lead vê o nome do atendente — nunca o nome da IA." (When you take over, the lead sees the agent's name — never the AI's name.)
Fields and filters
- "Atendente" (Agent)required
- Team list, starting at "Selecione…" (Select…). Choose who will handle it.
Buttons and actions
- "Assumir conversa" (Take over conversation)
- Assigns the conversation to the chosen agent and opens it in the Inbox, ready to reply. It stays disabled until someone is chosen; while sending it shows "Assumindo…" (Taking over…).
- "Devolver para a IA" (Return to the AI)
- Takes the conversation out of the queue and returns it to the AI. If it fails, the notice says it remains in the queue. When the account's AI has been turned off, the button gives way to the sentence "A IA desta conta foi desligada: a conversa segue com a equipe." (This account's AI has been turned off: the conversation stays with the team.)
Screen states
- Loading
- "Carregando a fila de transbordo…" (Loading the handoff queue…) until the first response (the "Na fila agora" (In queue now) card shows a dash and says loading); the selected lead's dossier appears as gray blocks until it arrives.
- Nothing here yet
- With nobody in the queue: "Nenhuma conversa aguardando transbordo humano." (No conversations waiting for human handoff.)
- If something goes wrong
- If the queue does not load: "Não foi possível carregar a fila de transbordo" (The handoff queue could not be loaded), with a notice that there may be people waiting that the screen could not read, and "Tentar de novo" (Try again). The "Na fila agora" (In queue now) card shows a dash.
- The lead's dossier did not load
- The block shows "Não foi possível carregar o dossiê" (The dossier could not be loaded), asks you not to decide from it until you reload, and offers "Tentar de novo" (Try again).
- There are no votes or ratings yet
- Handoff accuracy and "Satisfação (CSAT)" (Satisfaction (CSAT)) show a dash, with "sem feedback ainda" (no feedback yet) and "sem notas ainda" (no ratings yet).