Cada conversa e cada chamada é arquivada sob um cliente, a mesma pessoa em todos os seus canais. Os clientes só são unidos por dados que ninguém consegue falsificar, como o número de onde ligam ou o ID que o seu site assina para um visitante com sessão iniciada; um e-mail ou telefone que alguém digita fica guardado no perfil, e sua equipe une clientes no painel. Seus sistemas podem ler a base de clientes, mantê-la atualizada e adicionar o que acontece fora da EvaSay.
| Método | Caminho | O que faz |
|---|---|---|
| GET | /api/v1/voice/contacts | Clientes, os vistos mais recentemente primeiro: q busca em nomes, e-mails, telefones, empresas e etiquetas, segment_id mantém só os de um grupo, limit (até 100) e offset paginam |
| GET | /api/v1/voice/contacts/{id} | Um cliente com seus dados, etiquetas, consentimentos e seus próprios campos |
| PATCH | /api/v1/voice/contacts/{id} | Altere name, email, phone, company, city, country, language, timezone, tags ou attributes |
| GET | /api/v1/voice/contact-fields | Seus próprios campos de cliente: de cada um key, label, type e options |
| GET | /api/v1/voice/contacts/{id}/events | A linha do tempo do cliente, o mais recente primeiro |
| POST | /api/v1/voice/contacts/{id}/events | Adicione um evento dos seus próprios sistemas |
| GET | /api/v1/voice/contacts/{id}/consent | Cada mudança de consentimento, com a origem e a prova |
| POST | /api/v1/voice/contacts/{id}/consent | Registre uma mudança de consentimento |
| GET | /api/v1/voice/segments | Grupos de clientes; counts=true acrescenta quantos clientes cada um tem agora |
curl https://evasay.com/api/v1/voice/contacts/CONTACT_ID \
-X PATCH \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{ "company": "Acme Dental", "tags": ["vip"], "attributes": { "plan": "Gold" } }'
tags substitui todas as etiquetas do cliente. attributes recebe as chaves dos seus próprios campos (adicione-os na página Clientes; GET /api/v1/voice/contact-fields os lista) com um valor do tipo do campo; uma string vazia apaga um. Um valor que sua equipe digitou no painel é mantido: a API não o sobrescreve, e o agente também não. Mudar um e-mail ou telefone não une o cliente a outro que o tenha. Os dados padrão (name, email, phone e os demais) são substituídos como você os envia.
Envie o que acontece nos seus próprios sistemas, como uma compra, uma visita ou uma renovação, para que apareça na linha do tempo do cliente:
curl https://evasay.com/api/v1/voice/contacts/CONTACT_ID/events \
-X POST \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{ "event_id": "order-1042", "name": "order_paid", "subject": "Order 1042", "values": { "total": "89.00" } }'
name usa letras minúsculas, dígitos, _ e .. event_id é o seu próprio ID: o mesmo event_id no mesmo cliente é registrado uma única vez, então repetir é seguro, e accepted é false numa repetição. values contém texto, flags true ou false, e appointment_at é um horário em milissegundos Unix.
A EvaSay mantém quatro tipos de consentimento separados: marketing_email, marketing_sms, marketing_calls e service_calls (os dois tipos de chamada incluem chamadas com voz de IA). Cada um é granted, withdrawn ou, antes de qualquer registro, unknown. Uma mudança nunca é editada, só acrescentada ao histórico com a origem e a prova:
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
Só chaves de proprietários e administradores podem registrar consentimento, e note, a sua prova, é obrigatória.
Grupos são filtros salvos sobre a base de clientes: os que todo espaço de trabalho tem (todos os clientes, VIP, novos nos últimos 7 dias e outros), os do seu setor e os que você cria na página Clientes. GET /api/v1/voice/segments os lista com seu id; passe-o como segment_id para listar os clientes de um grupo.
Seus sistemas também podem saber das mudanças assim que acontecem: contact.created, contact.updated, contact.consent_changed e contact.merged são eventos de webhook.