ConverzillaSDK

Подключение библиотеки Converzilla SDK

Библиотека converzilla-sdk позволяет вашему сайту общаться с нативным приложением.

Она обеспечивает простой интерфейс вроде:

ConverzillaSDK.getContacts().then(...)

🛠 Способ 1: Подключение через CDN (быстро, без сборки)

1️⃣ Добавьте в <head> или перед закрывающим </body>:

<script src="https://cdn.jsdelivr.net/npm/converzilla-sdk/dist/converzilla.min.js"></script>

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<Contact[]>

📦 Что возвращается

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);
  });