> ## 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

> Solución a los problemas más comunes al integrar con la API de MarIA: firmas, autenticación, webhooks y plantillas

## Firmas inválidas en webhooks

* Verifica que lees el **RAW body** antes de cualquier parser/middleware.
* Recalcula HMAC y compara de forma tiempo‑constante.
* Consulta la guía de [Verificación de firmas HMAC](/maria/es/webhooks-firmas) para ejemplos completos.

## 401/403 en API

* Token caducado o con scope insuficiente.
* Reloj del servidor desincronizado (usa NTP).

## No llegan webhooks

* Endpoint no accesible o lento → revisar timeouts y reintentos.
* Filtro de IPs/firewall bloqueando las IPs de Omniloy.

## Plantillas rechazadas

* Variables desordenadas o sin contenido.
* Texto fuera de políticas de Meta.