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.

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.