Cada conversación y cada llamada se archiva bajo un cliente, la misma persona en todos tus canales. Los clientes solo se unen por datos que nadie puede falsificar, como el número desde el que llaman o el ID que tu sitio firma para un visitante con sesión iniciada; un correo o teléfono que alguien escribe se guarda en la ficha, y tu equipo une clientes en el panel. Tus sistemas pueden leer la base de clientes, mantenerla al día y añadir lo que ocurre fuera de EvaSay.
| Método | Ruta | Qué hace |
|---|---|---|
| GET | /api/v1/voice/contacts | Clientes, los vistos más recientemente primero: q busca en nombres, correos, teléfonos, empresas y etiquetas, segment_id deja solo los de un grupo, limit (hasta 100) y offset paginan |
| GET | /api/v1/voice/contacts/{id} | Un cliente con sus datos, etiquetas, consentimientos y tus propios campos |
| PATCH | /api/v1/voice/contacts/{id} | Cambia name, email, phone, company, city, country, language, timezone, tags o attributes |
| GET | /api/v1/voice/contact-fields | Tus propios campos de cliente: de cada uno key, label, type y options |
| GET | /api/v1/voice/contacts/{id}/events | La cronología del cliente, lo más reciente primero |
| POST | /api/v1/voice/contacts/{id}/events | Añade un evento desde tus propios sistemas |
| GET | /api/v1/voice/contacts/{id}/consent | Cada cambio de consentimiento, con su origen y su prueba |
| POST | /api/v1/voice/contacts/{id}/consent | Registra un cambio de consentimiento |
| GET | /api/v1/voice/segments | Grupos de clientes; counts=true añade cuántos clientes tiene cada uno ahora |
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 sustituye todas las etiquetas del cliente. attributes toma las claves de tus propios campos (añádelos en la página Clientes; GET /api/v1/voice/contact-fields los lista) con un valor del tipo del campo; una cadena vacía borra uno. Un valor que tu equipo escribió en el panel se conserva: la API no lo sobrescribe, y el agente tampoco. Cambiar un correo o un teléfono no une al cliente con otro que lo tenga. Los datos estándar (name, email, phone y los demás) se sustituyen tal como los envías.
Envía lo que pasa en tus propios sistemas, como una compra, una visita o una renovación, para que aparezca en la cronología del 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 minúsculas, dígitos, _ y .. event_id es tu propio ID: el mismo event_id en el mismo cliente se registra una sola vez, así que reintentar es seguro, y accepted es false en una repetición. values contiene texto, flags true o false, y appointment_at es una hora en milisegundos Unix.
EvaSay separa cuatro tipos de consentimiento: marketing_email, marketing_sms, marketing_calls y service_calls (los dos tipos de llamadas incluyen llamadas con voz de IA). Cada uno es granted, withdrawn o, antes de cualquier registro, unknown. Un cambio nunca se edita, solo se añade al historial con su origen y su prueba:
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
Solo las claves de propietarios y administradores pueden registrar consentimientos, y note, tu prueba, es obligatoria.
Los grupos son filtros guardados sobre la base de clientes: los que tiene todo espacio de trabajo (todos los clientes, VIP, nuevos en los últimos 7 días y otros), los de tu sector y los que creas en la página Clientes. GET /api/v1/voice/segments los lista con su id; pásalo como segment_id para listar los clientes de un grupo.
Tus sistemas también pueden enterarse de los cambios en cuanto ocurren: contact.created, contact.updated, contact.consent_changed y contact.merged son eventos de webhook.