API контактов

fetch("https://tallker.com/api/v1/public/contacts/upsert", { method: "POST", headers: { Authorization: "Bearer " + process.env.TALLKER_API_KEY, "Content-Type": "application/json" }, body: JSON.stringify({ external_id: "customer_18452", name: "Ivan", email: "ivan@example.com" }) });

POST/api/v1/public/contacts/upsertscope: contacts:write

Как это работает

1Создайте ключ со scope contacts:write.
2Передайте стабильный external_id и хотя бы имя, email или телефон.
3Сохраните возвращённый id Tallker либо продолжайте обращаться по external_id.

Примеры

fetch("https://tallker.com/api/v1/public/contacts/upsert", {
  method: "POST", headers: { Authorization: "Bearer " + process.env.TALLKER_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ external_id: "customer_18452", name: "Ivan", email: "ivan@example.com" })
});

Параметры и требования

Параметр	Требование	Описание
`external_id`	обязательно	Уникальный ID контакта в вашей системе
`name`	условно	Имя; требуется одно из name, email или phone
`email`	необязательно	Корректный email
`phone`	необязательно	7–15 цифр, нормализуется в международный формат
`company / metadata`	необязательно	Компания и произвольный JSON

Результат

{"id":"…","external_id":"customer_18452","created":false}

Лимиты и идемпотентность

120 requests / minute · HTTP 429 · Retry-After · Idempotency-Key 24h

Безопасность

Чтение: GET /api/v1/public/contacts/{external_id}, scope contacts:read.

При совпадении external_id обновляется тот же контакт; неизвестные JSON-поля отклоняются.

OpenAPI 3.1