# Message templates

{% hint style="info" %}
Access the message dashboard: <https://racemap.com/admin/message-templates>
{% endhint %}

<figure><img src="/files/H2IeGvwMI8PlNivv4aTu" alt=""><figcaption><p>Overview over the message dashbord with custom commands and public commands.</p></figcaption></figure>

**The message dashboard provides:**

* Private messages: Custom messages you create, accessible only in your account.
* Public messages: Provided by RACEMAP and available for all users.&#x20;

**Key features:**

* Device support: Manage message templates for a variety of tracker types supported in RACEMAP. For more details on supported hardware, visit [supported GPS devices](https://docs.racemap.com/hardware-for-live-tracking#various-gps-devices-for-live-tracking-in-racemap).
* Ownership control: Private messages can be applied only to devices you own or can edit. These messages cannot be shared with borrowers.
* Template ID: Each template is assigned a unique `templateId`, which is required when sending messages from external systems.&#x20;
* Export your private messages as GeoJSON files for external use.

{% hint style="info" %}

### Messaging through API <a href="#trackers-api" id="trackers-api"></a>

Independent from sending [commands through the UI of the tracker management](/tracker-management/messages.md) dashboard you can use message templates to integrate command sending into your system eg. to level up the automatization of your processes.

**URL** `https://racemap.com/api/v1/trackers/messages` \
**Method** Send \
**Sample message template** - Set report interval - for Queclink GL3xx GPS trackers: \
<https://racemap.com/admin/message-templates/6613c31ad019cb0ece29e251>&#x20;

Get the required `deviceId`(s) from the [current API](/api/current.md).&#x20;
{% endhint %}

#### Compose your own message templates

* Use the "Add template" button to create a new private message.
* Duplicate & edit: Copy an existing message and modify it to create a private version.&#x20;

<figure><img src="/files/iXMyzCxsBF7InQxwvmPB" alt=""><figcaption></figcaption></figure>

For each message template the below information must be provided.&#x20;

* Name: The name of the template&#x20;
* Variant: Either single or group&#x20;
  * Single: The same template is applicable for one or multiple trackers.&#x20;
  * Group: Groups several single templates with the same function for different tracker types (e.g., the "Shut down" command for GL300, LK106, and M20 grouped together).
* Description: Explain the effect of the message on the GPS tracker and clarify any parameters, including their units.
* Tracker types: Select the supported trackers to which the message applies.
* Allowed user roles: Specify whether the message can be used by you as the owner and or editors.
* Template: Provide the command, that will be send with the message.
* Arguments: If the command uses parameters, define them here.
* Example: A copyable example of the template.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.racemap.com/tracker-management/trackersapi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
