すべての会話と通話は顧客ごとに記録され、どのチャネルでも同じ人は同じ顧客です。顧客を自動で統合するのは、発信元の電話番号や、ログイン中の訪問者にサイトが署名した ID など、なりすませない情報だけです。本人が入力したメールアドレスや電話番号はプロフィールに保存され、顧客の統合はチームがダッシュボードで行います。自社システムから顧客ライブラリを読み取り、最新に保ち、EvaSay の外で起きたことを追加できます。
| メソッド | パス | 内容 |
|---|---|---|
| GET | /api/v1/voice/contacts | 顧客の一覧(最近の接触順):q で名前・メール・電話番号・会社名・タグを検索、segment_id で 1 つのグループに絞り込み、limit(最大 100)と offset でページ送り |
| GET | /api/v1/voice/contacts/{id} | 1 人の顧客の情報、タグ、同意状態、独自フィールド |
| PATCH | /api/v1/voice/contacts/{id} | name、email、phone、company、city、country、language、timezone、tags、attributes を変更 |
| GET | /api/v1/voice/contact-fields | 独自の顧客フィールド:それぞれの key、label、type、options |
| GET | /api/v1/voice/contacts/{id}/events | 顧客のタイムライン(新しい順) |
| POST | /api/v1/voice/contacts/{id}/events | 自社システムからイベントを追加 |
| GET | /api/v1/voice/contacts/{id}/consent | 同意の変更すべて(出所と証拠つき) |
| POST | /api/v1/voice/contacts/{id}/consent | 同意の変更を記録 |
| GET | /api/v1/voice/segments | 顧客グループ。counts=true で各グループの現在の顧客数も返します |
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 は顧客のタグをすべて置き換えます。attributes には独自フィールドのキー(顧客 ページで追加。GET /api/v1/voice/contact-fields で一覧)と、フィールドの型に合った値を渡します。空文字列でその値を消せます。チームがダッシュボードで入力した値は保持され、API でも Agent でも上書きされません。メールアドレスや電話番号を変えても、同じ値を持つ別の顧客とは統合されません。標準の項目(name、email、phone など)は送った値でそのまま置き換わります。
購入、来店、更新など自社システムで起きたことを送ると、顧客のタイムラインに表示されます:
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 には英小文字、数字、_、. を使います。event_id は自社の ID で、同じ顧客に同じ event_id は 1 回だけ記録されるため、再試行しても安全です。重複時は accepted が false になります。values はテキスト、flags は true か false、appointment_at は Unix ミリ秒の時刻です。
EvaSay は 4 種類の同意を分けて記録します:marketing_email、marketing_sms、marketing_calls、service_calls(2 種類の電話はどちらも AI 音声による電話を含みます)。それぞれ granted、withdrawn、または記録がまだないときは unknown です。変更は編集されず、出所と証拠を添えて履歴に追加されるだけです:
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
同意を記録できるのはオーナーと管理者のキーだけで、証拠となる note は必須です。
グループは顧客ライブラリに保存された絞り込み条件です。すべてのワークスペースにあるもの(全顧客、VIP、過去 7 日間の新規など)、業種ごとのもの、顧客 ページで自分で作ったものがあります。GET /api/v1/voice/segments で各グループとその id を取得し、segment_id として渡すと、そのグループの顧客を一覧できます。
変更をすぐに受け取ることもできます:contact.created、contact.updated、contact.consent_changed、contact.merged は Webhook イベント です。