> ## Documentation Index
> Fetch the complete documentation index at: https://omniloy.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Solving the most common issues when integrating with the MarIA API: signatures, authentication, webhooks, and templates

## Invalid webhook signatures

* Verify that you are reading the **RAW body** before any parser/middleware.
* Recompute the HMAC and compare in constant time.
* See the [HMAC Signature Verification](/maria/en/webhooks-firmas) guide for complete examples.

## 401/403 on API

* Expired token or insufficient scope.
* Server clock out of sync (use NTP).

## Webhooks not arriving

* Endpoint not reachable or too slow → check timeouts and retry settings.
* IP filter/firewall blocking Omniloy's IPs.

## Templates rejected

* Variables out of order or with empty content.
* Text outside Meta's content policies.