Como associar-se ao WhatsApp a partir de uma aplicação diferente
Existem várias formas da sua aplicação para iPhone interagir com o WhatsApp: ligações universais, esquemas de URL personalizados, extensão de partilha e API de interação de documentos.
Ligações universais
As ligações universais são o método preferido para associar-se a uma conta do WhatsApp.
Utilize https://wa.me/<number> onde <number> é um número de telemóvel completo em formato internacional. Omita quaisquer parêntesis, traços, sinais de mais e zeros à esquerda quando adicionar o número de telemóvel no formato internacional.
Exemplos:
Utilize: https://wa.me/15551234567
Não utilize: https://wa.me/+001-(555)1234567
As ligações universais também podem incluir uma mensagem pré-preenchida que será automaticamente apresentada no campo de texto de uma conversa. Utilize https://wa.me/whatsappphonenumber?text=urlencodedtext onde whatsappphonenumber é um número de telemóvel completo em formato internacional e urlencodedtext é a mensagem pré-preenchida com URL codificado.
Exemplo: https://wa.me/15551234567?text=I'm%20interested%20in%20your%20car%20for%20sale
Para criar uma ligação só com uma mensagem pré-preenchida, utilize https://wa.me/?text=urlencodedtext
Exemplo: https://wa.me/?text=I'm%20inquiring%20about%20the%20apartment%20listing`
Esquema de URL personalizado
Abrir o Whatsapp:// URL com um dos seguintes parâmetros irá abrir a nossa aplicação e efetuar uma ação personalizada.
URL | Parâmetros | Abre |
---|---|---|
aplicação | - | A aplicação WhatsApp Messenger |
enviar | Compositor de nova conversa | |
texto | Caso exista, este texto será pré-preenchido no campo de introdução de texto da mensagem num ecrã de conversa. | |
A chamada Objetivo-C para abrir um destes URL é a seguinte:
NSURL *whatsappURL = [NSURL URLWithString:@"whatsapp://send?text=Hello%2C%20World!"]; if ([[UIApplication sharedApplication] canOpenURL: whatsappURL]) { [[UIApplication sharedApplication] openURL: whatsappURL]; }
Certifique-se de incluir o esquema de URL do WhatsApp no Info.plist da sua aplicação na chave LSApplicationQueriesSchemes se pretende determinar se o WhatsApp está instalado no iPhone do utilizador utilizando -[UIApplication canOpenURL:].
Extensão de partilha
Introduzida na versão iOS 8.0, a Extensão de partilha é uma forma prática para qualquer aplicação partilhar conteúdos com outras aplicações instaladas no iPhone do utilizador. Esta é atualmente a forma preferida de partilha de conteúdos no WhatsApp. Para utilizar a Extensão de partilha, crie uma instância de UIActivityViewController e apresente-a na sua aplicação. O WhatsApp aceita os seguintes tipos de conteúdos:
- texto (UTI: public.plain-text);
- fotografias (UTI: public.image);
- vídeos (UTI: public.movie);
- notas de áudio e ficheiros de música (UTI: public.audio);
- documentos PDF (UTI: com.adobe.pdf);
- cartões de contacto (UTI: public.vcard);
- URL da web (UTI: public.url).
Interação de documentos
Se a sua aplicação cria fotografias, vídeos ou notas de áudio e se quer que os seus utilizadores partilhem estes ficheiros utilizando o WhatsApp, pode utilizar a API de interação de documentos para enviar os ficheiros para os seus contactos e grupos do WhatsApp.
O WhatsApp Messenger pode processar vários tipos de ficheiros:
- imagens de qualquer tipo em conformidade com public.image (por exemplo, PNG e JPEG);
- vídeos de qualquer tipo em conformidade com public.movie (por exemplo, vídeo MPEG-4);
- ficheiros de áudio (apenas MPEG-3, MPEG-4, AIFF, AIFF-C e Core Audio).
Alternativamente, se quiser que apareça apenas o WhatsApp na lista de aplicações (em vez de aparecer o WhatsApp juntamente com outras aplicações em conformidade com public/*), pode especificar um ficheiro ou um dos tipos supramencionados guardados com a extensão exclusiva do WhatsApp:
- imagens - «.wai» que é do tipo net.whatsapp.image
- vídeos - «.wam» que é do tipo net.whatsapp.movie
- ficheiros de áudio - «.waa» que é do tipo net.whatsapp.audio
Quando acionado, o WhatsApp irá apresentar de imediato ao utilizador o ecrã de seleção de contacto/grupo. O ficheiro multimédia será enviado automaticamente para um contacto/grupo selecionado.
Para mais informações acerca da partilha de ficheiros multimédia no WhatsApp, consulte os recursos no site de Programador da Apple.