Mudar a conversa e registrar conversões
Além de enviar elementos nativos, o resultado da sua ferramenta pode mudar a conversa (status e tags) e registrar uma conversão, sem uma segunda chamada e sem depender da IA lembrar de fazer isso.
Status e tags: atalia.status e atalia.tags
{
"data": { "pedido": "PED-1042", "pago": true },
"atalia": {
"send": [{ "type": "text", "text": "Pagamento confirmado! Obrigado pela preferência." }],
"tags": { "add": ["venda-ganha"], "remove": ["aguardando-pagamento"] },
"status": "closed",
"final": true
}
}
As duas chaves não dependem de send: uma ferramenta pode só classificar a conversa.
{
"data": { "lead_score": 87 },
"atalia": { "tags": ["lead-quente"], "status": "waiting" }
}
status
open (aberta), waiting (aguardando) ou closed (fechada). Outro valor volta como erro para a IA. Pedir o status que a conversa já tem não faz nada. Fechar também cancela os follow-ups pendentes da conversa.
tags
{ "add": [...], "remove": [...] }, ou só uma lista, que vale comoadd.- Cada item pode ser o nome, o slug ou o id da tag. Até 20 em cada lista.
- Tags não são criadas. Se o nome não existir na empresa, as outras são aplicadas e o nome desconhecido volta para a IA corrigir. Assim um erro de digitação do modelo não enche a conta de tags. Crie as tags antes, em Tags.
Ordem
- Os envios de
send, na ordem. - As tags: primeiro
add, depoisremove. - O status.
O envio vem antes para fechar a conversa não atropelar a mensagem. As tags vêm antes do status para que uma regra que dependa de tag (por exemplo, uma Conversão da Meta "fechou com a tag venda-ganha") já enxergue a tag quando o status mudar.
O que acontece junto
É o mesmo caminho de quando um atendente muda pelo painel, com todos os efeitos:
- registro no histórico da conversa e atualização na tela dos atendentes, na hora;
- contadores da caixa de entrada e grupos de contato dinâmicos;
- gatilhos de fluxo de "tag adicionada" e "conversa atualizada";
- Conversões da Meta configuradas para tag adicionada, tag removida e mudança de status.
Registrar conversões: event
Para medir o que a conversa gerou (uma compra, um lead qualificado), devolva um objeto event no resultado. A Atalia registra o evento na conversa, mostra em tempo real e ignora repetidos pelo event_id.
{
"success": true,
"data": {
"pedido": "PED-1042",
"event": {
"event_name": "purchase",
"event_id": "PED-1042_purchase",
"value": 52.70,
"metadata": { "payment_method": "pix", "currency": "BRL" }
}
}
}
| Campo | Obrigatório | O que é |
|---|---|---|
event_name | Sim | O tipo do evento, em snake_case (ver a lista abaixo). |
event_id | Sim | Identificador único. O mesmo event_id de novo não registra duas vezes: use algo como <pedido>_purchase. |
value | Não | Valor numérico, em reais (ex.: o total do pedido). |
metadata | Não | Campos livres para detalhar. |
A Atalia procura o event em event, data.event, [0].event ou [0].data.event, com o resultado em objeto ou em texto JSON. Ele convive com a chave atalia no mesmo resultado.
Nomes de evento
| Uso | Eventos |
|---|---|
| Vendas | purchase (pedido pago), add_to_cart, initiate_checkout, cart_abandoned |
| Leads | lead (novo lead), qualified_lead (lead qualificado), view_content |
| Opinião | rating_provided (nota), review_provided (avaliação) |
Exemplo: qualificar o lead e encaminhar
A ferramenta qualificar_lead calcula a nota no seu CRM, registra o evento, marca a conversa e deixa aguardando a equipe comercial:
{
"success": true,
"data": {
"lead_id": "L-778",
"nota": 87,
"event": { "event_name": "qualified_lead", "event_id": "L-778_qualified", "value": 87 }
},
"atalia": {
"send": [{ "type": "text", "text": "Perfeito! Uma pessoa do nosso time comercial vai falar com você em instantes." }],
"tags": ["lead-quente"],
"status": "waiting",
"final": true
}
}