O PocketHook disponibiliza seis App Intents que se integram com a Siri e a app Atalhos do iOS. Pode usá-los para criar automatizações poderosas acionadas por voz, hora, localização ou outros gatilhos do iOS.
Enviar Mensagem#
Intent: SendMessageIntent
Envia uma mensagem para o seu servidor e, opcionalmente, aguarda a resposta.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| Mensagem | string | A mensagem a enviar |
| Aguardar Resposta | boolean | Se verdadeiro, faz polling até 5 minutos |
Exemplo: “Hey Siri, envia ‘verificar servidores’ com o PocketHook”
Devolve o texto de resposta do servidor se a espera estiver ativada.
Enviar Dados para o Servidor#
Intent: SendDataToServerIntent
Envia uma mensagem para o seu servidor silenciosamente — sem a adicionar ao histórico do chat. Útil para automatizações em segundo plano.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| Mensagem | string | A mensagem a enviar |
Exemplo: Crie uma automatização de Atalhos que corre todas as manhãs e envia “daily-report” para o seu servidor.
Extrair Mensagem#
Intent: ExtractMessageIntent
Extrai o campo msg de uma string JSON de resposta do PocketHook.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| JSON de Resposta | string | A resposta JSON em bruto |
Devolve: A string msg da resposta.
Extrair Dados#
Intent: ExtractDataIntent
Extrai o objeto data de uma string JSON de resposta do PocketHook.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| JSON de Resposta | string | A resposta JSON em bruto |
Devolve: O objeto data como uma string JSON.
Extrair Nome do Atalho#
Intent: ExtractShortcutIntent
Extrai o nome do shortcut de uma string JSON de resposta do PocketHook.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| JSON de Resposta | string | A resposta JSON em bruto |
Devolve: A string com o nome do atalho.
Adicionar Mensagem Local#
Intent: AddLocalMessageIntent
Adiciona uma mensagem ao histórico de chat local sem enviar nada para o servidor. Útil para registar automatizações localmente.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| Mensagem | string | O texto da mensagem a adicionar |
| Remetente | enum | user ou server |
Construir Automatizações com Atalhos#
Básico: Enviar e Apresentar#
- Adicione a ação Enviar Mensagem (aguardar resposta: sim)
- Adicione Mostrar Resultado com o resultado
Avançado: Analisar e Agir#
- Enviar Mensagem → obter a resposta em bruto
- Extrair Dados → obter os dados
- Utilize os dados extraídos noutras ações de Atalhos (ajustar brilho, abrir app, etc.)
Automatização em Segundo Plano#
- Crie uma automatização de Hora do Dia
- Adicione Enviar Dados para o Servidor com o seu comando de acionamento
- O servidor processa-o e pode acionar Atalhos de volta através do PocketHook
Encadear com Outras Apps#
Os intents do PocketHook funcionam com qualquer ação de Atalhos. Combine-os com:
- Ações de Casa para controlar dispositivos inteligentes
- Calendário/Lembretes para ler ou criar eventos
- Ficheiros para processar documentos
- Saúde para registar dados de treino
- Qualquer outra app compatível com Atalhos