This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
trigger:URL [2018/05/22 15:03] JMichaelTX Rewrite usage and add examples. |
trigger:URL [2025/03/07 03:06] (current) peternlewis |
||
---|---|---|---|
Line 10: | Line 10: | ||
"[&value=<TriggerValue>]" is the option to pass "<TriggerValue>" as the Macro %TriggerValue% | "[&value=<TriggerValue>]" is the option to pass "<TriggerValue>" as the Macro %TriggerValue% | ||
• Do not include the square brackets [ ] in the actual URL. | • Do not include the square brackets [ ] in the actual URL. | ||
- | • Do not include the "%value=" without a value. | + | • Do not include the "&value=" without a value. |
You can pass a trigger value to the macro by adding the "value" query parameter to the URL. The parameter is available to the macro as the [[token:TriggerValue|%TriggerValue% text token]] (v7.0+). | You can pass a trigger value to the macro by adding the "value" query parameter to the URL. The parameter is available to the macro as the [[token:TriggerValue|%TriggerValue% text token]] (v7.0+). | ||
+ | |||
+ | Note that the URL must be validly encoded. The UUID is always validly encoded, but if you use the Name or a Value, ensure they are correctly encoded URL fields. | ||
+ | |||
+ | For other ways to use a `URL` to trigger a macro, see:\\ | ||
+ | [Macro Triggers that Use a URL](https://forum.keyboardmaestro.com/t/request-for-a-working-example-of-remote-trigger/10844/10?u=jmichaeltx), 2018-07-15, peternlewis | ||
===== Examples ===== | ===== Examples ===== | ||
Line 42: | Line 47: | ||
* [[Script|Script]] trigger | * [[Script|Script]] trigger | ||
* [[URL|URL]] trigger | * [[URL|URL]] trigger | ||
+ | * [[keyboardmaestro|keyboardmaestro CLI Tool]] | ||
* [[Trigger File|Trigger File]] | * [[Trigger File|Trigger File]] | ||
* [[/Triggers|All Triggers]] | * [[/Triggers|All Triggers]] |