O Google Home app (GHA) é a principal maneira de conectar dispositivos inteligentes a Google Assistant e atribuí-los a estruturas e salas em Google Home Graph. Para fazer a configuração, os usuários geralmente clicam em várias telas para encontrar sua ação smart home em uma lista de opções disponíveis. Ao facilitar o início do processo de configuração, você pode ajudar a integrá-los mais rapidamente e reduzir a frustração da configuração do usuário.
Para simplificar a integração do usuário em dispositivos smart home, a plataforma smart home do Google oferece vários recursos de conveniência que facilitam o acesso rápido ao usuário para que ele entre no fluxo de configuração e comece a usar o dispositivo smart home. Esses recursos podem ser facilmente integrados às suas ações do smart home com pouco ou nenhum esforço de codificação.
A lista a seguir resume os recursos da plataforma que você pode implementar para reduzir o atrito do usuário quando ele configura os dispositivos inteligentes para Assistant:
- App Discovery: esse recurso permite que os usuários vejam ícones de sugestão para vincular à ação no GHA. Ao clicar no ícone, eles podem conectar os dispositivos smart home a Assistant usando as contas de provedores de terceiros.
- Link direto: este recurso permite que você incorpore um link direto no seu app ou site do produto para que os usuários conectem facilmente o dispositivo smart home ao Assistant. Clicar no link solicita que os usuários façam o download do GHA (se ainda não estiver instalado) e inicia o fluxo de configuração da atribuição de sala e vinculação da conta.
Implementar a descoberta de apps
Você pode ativar o recurso App Discovery no Actions on Google Console depois de concluir o processo de verificação da marca. Não é necessário alterar o código, mas a ação smart home precisa ser revisada e estar em produção.
Faça login no Actions Console:
Acessar o console do Actions on Google
- Abra seu projeto de ação smart home.
- Clique em Implantar > Verificação de marca.
- Siga estas etapas para conectar o site da sua empresa ao projeto do Actions.
- No painel Websites, clique em Conectar site.
- Insira o URL do site que você quer conectar e clique em Conectar. O Google envia um e-mail para o proprietário do site para confirmar a associação.
No painel Apps Android, clique no botão Conectar app e siga as instruções mostradas.
No mesmo painel, alterne a opção Ativar descoberta de apps para o app conectado. Essa opção fica esmaecida até que a ação seja revisada e aprovada.
Link direto para o Google Home
Os links diretos permitem que você leve os usuários diretamente para um destino específico no GHA do seu app Android ou iOS, simplificando o processo de configuração do dispositivo com Assistant.
A sintaxe dos links diretos GHA é a seguinte:
https://madeby.google.com/home-app/?deeplink=destination
No momento, seu app Android ou iOS pode ser vinculado aos seguintes destinos no GHA:
Destino | Descrição |
---|---|
setup/ha_linking?agent_id=agent-id
|
Inicia o
fluxo de vinculação da conta OAuth para o agent-id
da ação smart home.
|
O caminho de destino precisa ser codificado por URL corretamente antes de ser aplicado ao link direto. Por exemplo:
https://madeby.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-id
Para ver mais detalhes sobre como acionar links diretos no seu app, consulte a documentação relevante do Android e a documentação do iOS.