ConverzillaSDK
Подключение библиотеки Converzilla SDK
Библиотека converzilla-sdk позволяет вашему сайту общаться с нативным приложением.
Она обеспечивает простой интерфейс вроде:
ConverzillaSDK.getContacts().then(...)
🛠 Способ 1: Подключение через CDN (быстро, без сборки)
1️⃣ Добавьте в или перед закрывающим :
2️⃣ После загрузки библиотека будет доступна как глобальный объект:
ConverzillaSDK.default.getContacts()
.then(contacts => {
console.log('Контакты:', contacts);
})
.catch(error => {
console.error('Ошибка:', error);
});
🛠 Способ 2: Установка через npm/yarn (если есть сборка)
1️⃣ Установите:
npm install converzilla-sdk
или
yarn add converzilla-sdk
2️⃣ Импортируйте в коде:
import ConverzillaSDK from 'converzilla-sdk';
ConverzillaSDK.getContacts()
.then(contacts => {
console.log('Контакты:', contacts);
})
.catch(error => {
console.error('Ошибка:', error);
});
⚠️ Важные замечания
✅ Работает только внутри приложения , которое интегрирует нативную часть.
✅ Если вы тестируете в обычном браузере — нативные вызовы будут недоступны.
[getContacts] Получение контактов пользователя
📌 Описание
Метод getContacts() запрашивает у нативного приложения список контактов пользователя.
Возвращает Promise с массивом объектов, содержащих подробности о каждом контакте.
📤 Сигнатура
ConverzillaSDK.getContacts(): Promise
📦 Что возвращается
Promise, который:
✅ при успешном выполнении — возвращает массив Contact[]
❌ при ошибке — отклоняется с описанием ошибки.
📄 Структура объекта Contact
interface Contact {
recordID: string;
displayName: string;
familyName: string;
givenName: string;
middleName: string;
phoneNumbers: Array<{ label: string; number: string }>;
emailAddresses: Array<{ label: string; email: string }>;
postalAddresses: Array<{
label: string;
formattedAddress: string;
street: string;
city: string;
state: string;
country: string;
postCode: string;
}>;
birthday?: { day: number; month: number; year: number };
company?: string;
jobTitle?: string;
note?: string;
}
💻 Пример использования
ConverzillaSDK.getContacts()
.then(contacts => {
console.log('Найдено контактов:', contacts.length);
contacts.forEach(contact => {
console.log(`Имя: ${contact.displayName}`);
contact.phoneNumbers.forEach(phone =>
console.log(`Телефон (${phone.label}): ${phone.number}`)
);
});
})
.catch(error => {
console.error('Ошибка при получении контактов:', error);
});