Как связать WhatsApp с другим приложением
iOS
Приложение на iPhone может взаимодействовать с WhatsApp разными способами. При этом могут использоваться универсальные ссылки, пользовательские схемы URL, расширения общих сетевых ресурсов и API Document Interaction.
Универсальные ссылки
Чтобы дать ссылку на учётную запись в WhatsApp, рекомендуем воспользоваться универсальными ссылками.
Используйте
https://wa.me/<number>, где <number> — полный номер телефона в международном формате. Не используйте скобки, дефисы, знак плюса и начальные нули при вводе номера телефона в международном формате.Примеры:
Используйте:
https://wa.me/75551234567.Не используйте:
https://wa.me/+007-(555)1234567.Универсальные ссылки также могут включать автоматически заполненное сообщение, которое будет отображено в текстовом поле чата. Используйте
https://wa.me/whatsappphonenumber/?text=urlencodedtext, где whatsappphonenumber — полный номер телефона в международном формате, а URL-текст — предварительно заполненное сообщение, закодированное в URL-адресе.Пример:
https://wa.me/75551234567?text=Здравствуйте,%20интересует%20ваше%20объявление%20о%20продаже%20машины.Чтобы создать ссылку только с автоматическим сообщением, используйте
https://wa.me/?text=urlencodedtext.Пример: https://wa.me/?text=Меня%20интересует%20объявление%20о%20продаже%20квартиры.
Пользовательская схема URL
Открытие URL-адреса whatsapp:// с одним из следующих параметров откроет приложение и выполнит настраиваемое действие.
| URL | Параметры | Открывает |
|---|---|---|
app | - | Приложение WhatsApp Messenger |
send | Новый чат | |
| текст | При наличии здесь текста он будет отображён в поле ввода на экране чата. |
Для открытия этих URL используется следующий вызов Objective-C:
NSURL *whatsappURL = [URL NSURLWithString:@"whatsapp://send?text=Hello%2C%20World!"]; if ([[UIApplication sharedApplication] canOpenURL: whatsappURL]) { [[UIApplication sharedApplication] openURL: whatsappURL]; }
Обязательно включите схему URL WhatsApp в Info.plist своего приложения в ключе LSApplicationQueriesSchemes, если хотите определить, установлен ли WhatsApp на телефоне пользователя, с помощью [UIApplication canOpenURL:].
Расширения общих сетевых ресурсов
Впервые представленное в iOS 8.0 расширение общих сетевых ресурсов представляет собой удобный способ делиться контентом любого приложения с другими приложениями, установленными на телефоне пользователя. Сегодня это предпочтительный способ отправки вашего контента через WhatsApp. Чтобы использовать расширение общего сетевого ресурса, создайте экземпляр UIActivityViewController и представьте его в своём приложении. В WhatsApp допустимы следующие виды контента:
- текст (UTI: public.plain-text);
- фото (UTI: public.image);
- видео (UTI: public.movie);
- аудиозаметки и музыкальные файлы (UTI: public.audio);
- файлы PDF (UTI: com.adobe.pdf);
- карточки контактов (UTI: public.vcard);
- ссылки URL (UTI: public.url).
API Document Interaction
Если ваше приложение создаёт фото, видео или аудиозаметки, и вы хотите, чтобы пользователи делились ими в WhatsApp, вы можете использовать API Document Interaction, чтобы отправлять медиафайлы своим контактам или в группы WhatsApp.
WhatsApp Messenger работает с различными видами медиафайлов. Это могут быть:
- любые изображения, соответствующие public.image (например, PNG и JPEG);
- любые видео, соответствующие public.movie (например, MPEG-4);
- аудиофайлы (только MPEG-3, MPEG-4, AIFF, AIFF-C и Core Audio);
Также, если вы хотите показать в списке приложений только WhatsApp (а не WhatsApp и другие вышеперечисленные приложения, соответствующие public/*), вы можете указать файл допустимого формата, сохранённый с расширением, характерным для WhatsApp:
- изображения — «.wai», который имеет тип net.whatsapp.image;
- видео — «.wai», который имеет тип net.whatsapp.movie;
- аудиофайлы — «.wai», который имеет тип net.whatsapp.audio.
При нажатии будет немедленно открыт экран выбора контакта или группы в WhatsApp. Медиафайл будет автоматически отправлен в выбранный индивидуальный или групповой чат.
Дополнительную информацию об отправке медиафайлов в WhatsApp можно получить на веб-сайте разработчиков Apple.
