A Siri pode acionar seu app. Qual função você deve disponibilizar primeiro?

Uma encomenda está atrasada. A pessoa quer saber se ela vai chegar ao escritório antes de sair, mas a resposta útil está atrás de uma tela de login, de uma lista de pedidos e de uma página de rastreamento. Um pedido em linguagem natural pode encurtar esse caminho se o app der à assistente uma forma bem definida de encontrar a entrega certa.

Em 3 de novembro, a Apple abriu a prévia da Siri AI para desenvolvedores com App Intents em sistemas beta, incluindo o iOS 27.3. A prévia permite conectar apps a solicitações que podem usar o contexto pessoal, as informações na tela e ações relacionadas. A Apple pretende levar a integração ao público mais adiante, com envios para a App Store previstos para a primavera no hemisfério norte. Os desenvolvedores podem definir o comportamento de uma ação antes que as pessoas passem a depender dela.

Siri em 2014, em foto de Kārlis Dambrāns. Imagem recortada e redimensionada, CC BY 2.0. Fonte da imagem · Licença.

Dê à assistente uma tarefa com um resultado reconhecível

Consulta por App Intent. Ilustração original da Telli.sh.

Um App Intent representa uma operação que o app está preparado para executar. Pense em um app de entregas que disponibiliza uma consulta de status. A entrada pode ser uma entidade de envio que o app sabe identificar. O resultado pode indicar o envio, o status mais recente e a hora da atualização. O app é responsável pelos dados e decide o que a conta autenticada tem permissão para ver.

Esse desenho mantém a interação curta e ajuda a chegar a uma resposta precisa. Se uma conta tem três entregas em andamento, a assistente precisa de informações suficientes para distingui-las. Um código de rastreamento, um nome curto ou um destino reconhecível podem tornar a escolha concreta. Uma expressão ambígua como “minha encomenda” deve levar a um pedido de esclarecimento quando houver mais de um resultado possível.

As duas primeiras linhas são bons pontos de partida. Geralmente permitem dar uma resposta útil sem criar uma transação. Mudar uma reserva envolve condições diferentes. O horário desejado pode estar indisponível, o local pode cobrar uma taxa ou uma conversão de fuso pode mudar a data. Essas condições precisam aparecer na ação do app e na resposta.

Deixe o app verificar as permissões na hora de agir

Escrita por App Intent. Ilustração original da Telli.sh.

A assistente pode interpretar a frase e identificar uma ação possível. O app ainda precisa verificar quem fez o pedido, a qual objeto essa pessoa pode ter acesso e se a operação pode prosseguir. Aplique nesse caminho as mesmas verificações da interface atual do app. Uma solicitação em linguagem natural às vezes chega enquanto a pessoa usa outra conta, em um dispositivo bloqueado ou depois que a sessão expirou.

Um compromisso financeiro merece uma última exibição do valor e de quem será cobrado. Em uma mudança de entrega, mostre o destino antes da confirmação. Se o backend não souber se uma solicitação deu certo, o app deve informar uma situação que a pessoa consiga esclarecer, evitando induzi-la a enviar o mesmo pedido de novo. Quem já montou uma tela de pagamento conhece essas regras. A diferença é que uma interação por voz ou chat talvez precise oferecer a mesma clareza em muito menos espaço.

Veja um caso simples. Uma pessoa pede para comprar de novo um pacote de café. O primeiro pedido pode ter sido feito com desconto temporário, o endereço de entrega escolhido pode estar desatualizado e o produto pode ter vários tamanhos. Uma experiência segura apresenta o item, o tamanho, o preço e o endereço atuais antes de o app fazer o pedido. Também pode facilitar a localização do comprovante depois.

O contexto da pessoa ajuda a encontrar o ponto de partida certo. Deve ficar claro quais partes desse contexto o app usou. Uma confirmação que diz “o pedido que está na tela” pode servir quando há apenas um pedido visível. Se a tela mostrar vários itens, repita a escolha específica. Dê à pessoa a chance de corrigir a interpretação antes da ação.

Uma sequência de ações precisa mostrar como terminou de fato

A Apple também descreve skills que combinam ações e o suporte a entidades no índice semântico do Spotlight. Juntos, esses recursos podem reduzir o número de telas entre uma solicitação e o resultado. Também tornam os erros pequenos de cada operação mais importantes, porque a saída de uma ação pode ser a entrada da próxima.

Imagine um pedido para localizar uma reserva próxima e mudar o horário. A consulta pode funcionar enquanto a alteração falha. Informe os dois resultados. Dizer que a reserva foi encontrada e continua no horário original dá à pessoa uma informação útil e um próximo passo claro. Uma mensagem genérica de sucesso esconderia a falha, e um erro genérico esconderia a consulta bem-sucedida.

Uma sequência prática costuma precisar de vários tipos de resultado. Uma etapa pode devolver um item possível. Uma etapa posterior pode pedir uma escolha ou confirmação. A última pode devolver um comprovante ou informar que a operação está pendente. Ao combinar ações, teste tanto o caminho em que a pessoa muda de ideia no meio do processo quanto o caso em que uma chamada de rede demora mais do que seria razoável esperar.

Use internamente um identificador estável para cada registro. Os nomes em linguagem natural mudam, e vários itens podem ter nomes parecidos. IDs estáveis permitem ao app saber se agiu sobre o objeto pretendido e ainda apresentar uma descrição compreensível. Mantenha um link para o registro de origem, para que quem precisa de contexto possa reabrir o app na tela certa.

Experimente a prévia com uma ação que você consiga conferir à mão

1. Consulte o anúncio da Apple para desenvolvedores para identificar o sistema beta, o dispositivo e o idioma compatíveis. Use uma conta e dados de teste. A Apple inclui o coreano entre os idiomas aceitos e descreve restrições por dispositivo e região.
2. Escolha uma ação de leitura que as pessoas já façam com frequência. Anote o caminho normal na interface e a resposta exata esperada quando a ação der certo.
3. Use a documentação do App Intents da Apple para modelar a ação e a entidade envolvida. Decida o que deve acontecer se a solicitação encontrar zero, um ou vários registros.
4. Teste a ação em casos normais e ambíguos. Inclua ausência de conta, sessão expirada, nomes duplicados e falta de rede. Compare cada resultado com a tela atual do app.
5. Para uma futura ação de escrita, registre onde a pessoa vê o objeto, as condições e o resultado. Acrescente um teste que repete a solicitação após um tempo limite e verifica se o app lida corretamente com ela.
6. Trate o lançamento para clientes e a prévia para desenvolvedores como etapas distintas. Confira novamente as informações atuais da Apple sobre envios e políticas ao planejar um lançamento na App Store.

É um bom momento para testar variações de linguagem. Um app de entregas pode começar pelas frases que os clientes usam para falar com o atendimento. Algumas incluem uma data, outras citam a loja e outras identificam a encomenda pelo local. Veja como a ação pede um detalhe ausente quando a fala está incompleta. Um bom esclarecimento aproxima a pessoa da resposta.

Escolha onde apresentar o resultado

A Apple distingue entidades do app no Spotlight, ações específicas do app, snippets e skills que combinam ações. Um app de entregas pode decidir qual dessas formas atende a uma pergunta concreta. Uma entidade na busca pode ajudar a pessoa a reconhecer um pedido. Uma ação pode interpretar uma solicitação de acordo com a conta atual. Um cartão pode tornar o resultado legível de relance. Uma sequência é útil quando encontrar o pedido é só o primeiro passo.

Em uma consulta de status, um cartão pode mostrar a cidade de destino, a situação atual e a hora da última atualização da transportadora. O nível de detalhe adequado depende de onde o cartão aparece e de o dispositivo estar bloqueado. Teste a tela sem contar com um aviso falado. Teste a versão por voz sem depender da tela para comunicar uma informação essencial. Os mesmos dados precisam fazer sentido nos dois casos.

O guia da prévia também explica como a assistente identifica o app de destino. Uma ação personalizada exige o nome do app quando ele está em segundo plano, salvo nos contextos a seguir. Um app em primeiro plano, uma Live Activity ativa ou uma conversa em que o app já foi citado podem fornecer o contexto necessário. Teste primeiro uma chamada explícita para confirmar que a ação funciona. Depois, tente a mesma solicitação na tela inicial, com outro app visível e no meio de uma conversa. Registre o resultado em cada contexto.

Teste o canal de distribuição separadamente

O guia da prévia descreve os testes em dispositivos com builds assinadas para desenvolvimento e os testes via TestFlight interno. Segundo o guia, as builds do TestFlight externo e as da App Store não conseguem executar essas integrações da prévia. Isso importa quando alguém da área de produto pede um piloto com clientes. Uma demonstração válida em uma build de desenvolvimento não estabelece que um cliente possa ativar o mesmo recurso em uma build distribuída pela loja.

A Apple informa que o recurso exige hardware compatível com Apple Intelligence e aceita seis idiomas, incluindo o coreano. Também há restrições de região, idade e servidor. Para a Siri AI, a Apple lista as betas 27.3 do iOS, iPadOS, macOS, watchOS e visionOS. A prévia inicial para desenvolvedores de terceiros cita iOS, iPadOS, macOS e visionOS. Separe esses escopos ao distribuir os testes. Um relatório bem identificado ajuda a próxima pessoa a entender se uma aparente falha veio da ação, do canal de teste ou do dispositivo.

Um teste interno útil tem uma linha por solicitação, dispositivo, idioma, canal de distribuição e resultado. Comece por um caso que você sabe que funciona. Em uma consulta de status em coreano, compare uma frase curta e coloquial com uma solicitação que inclui o lojista ou a data de rastreamento. Se as duas chegarem ao mesmo registro, a interação superou uma variação útil. Se uma mostrar o pedido de outra pessoa, pare o teste e corrija a autorização na origem.

Na verificação final, inclua um repasse normal para a pessoa. Se o intent encontrar uma reserva sem conseguir mudá-la, mostre o horário disponível e abra a tela certa. Se ele conseguir fazer a alteração, mostre o resultado e permita que a pessoa encontre o comprovante no app mais tarde. Nos dois casos, a pessoa tem um próximo passo específico.

Um atalho ganha confiança uma ação por vez

O atrativo da integração com a Siri AI é aproximar a função mais útil do app de quem precisa dela. Uma ação limitada e verificável já pode ter valor, sem exigir um catálogo amplo de integrações. Uma empresa que sabe exibir o status certo de uma entrega tem um bom lugar para começar.

À medida que incluir ações, use o mesmo padrão para cada uma. A pessoa precisa entender o que o app encontrou, o que ele pediu permissão para fazer e o que aconteceu depois. Essa clareza pesa ainda mais quando um pedido passa por vários serviços ou quando a pessoa nunca abre a janela original do app.

Fontes

• Anúncio da prévia da Siri AI de 3 de novembro no Apple Developer
• Documentação da Apple sobre App Intents
• Guia da Apple para configurar e testar a prévia para desenvolvedores
• Documentação da Apple sobre Spotlight e App Intents

---

Para guardar e encontrar as conversas e decisões que fazem parte do seu trabalho, crie uma conta na Telli.sh.