mirror of
https://github.com/Luchexx/wacrm.git
synced 2026-11-02 17:29:45 +00:00
e46844d527
Per Meta's brand-use guidance for third-party products, the registered
trademark symbol (®) should appear on the FIRST mention of "WhatsApp"
on each user-facing page. Subsequent mentions on the same page are
left plain.
Surfaces touched (one-per-page first mention):
- Landing hero badge ("Built on the official WhatsApp® Business API").
- src/lib/seo/site-config.ts: SITE_TAGLINE and SITE_DESCRIPTION
(rendered into <title> and <meta description> on every page).
- src/app/opengraph-image.tsx: hero text in social-share image.
- Settings, Inbox connection banner, Automations page subtitle.
- README.md tagline.
- All public docs pages (docs/README.md, docs/whatsapp-setup.md,
docs/getting-started.md, docs/supabase-setup.md,
docs/environment-variables.md, docs/deployment-hostinger.md,
docs/automations-and-cron.md, docs/architecture.md,
docs/troubleshooting.md).
Out of scope: SITE_KEYWORDS (the meta-keywords array isn't
user-rendered text — putting ® on every keyword would look broken in
the meta tag).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
78 lines
2.3 KiB
Markdown
78 lines
2.3 KiB
Markdown
# Automations cron
|
|
|
|
WaCRM's **Automations** module lets you build flows that react to WhatsApp®
|
|
events (new message, new contact, keyword match, schedule, etc.). Most
|
|
steps run inline — the exception is the **Wait** step, which parks the
|
|
execution in `automation_pending_executions` until its due time.
|
|
|
|
A cron job has to drain that table. If you skip this, Wait steps never
|
|
resume and any flow that uses them stalls.
|
|
|
|
## The endpoint
|
|
|
|
```
|
|
GET /api/automations/cron
|
|
Header: x-cron-secret: <AUTOMATION_CRON_SECRET>
|
|
```
|
|
|
|
- Returns `{ "processed": <n> }` with how many rows were claimed.
|
|
- Returns `503` if the env var is not set.
|
|
- Returns `401` if the header is missing or wrong.
|
|
|
|
The route claims up to 50 pending rows per call via a two-step
|
|
UPDATE-by-id so overlapping calls don't double-process.
|
|
|
|
## 1. Generate the secret
|
|
|
|
Any long random string works. One option:
|
|
|
|
```bash
|
|
openssl rand -hex 32
|
|
```
|
|
|
|
Copy the result into `AUTOMATION_CRON_SECRET` in your deployment env.
|
|
|
|
## 2. Schedule the pinger
|
|
|
|
### Option A — hPanel cron (Hostinger Managed Node.js)
|
|
|
|
hPanel → **Advanced → Cron Jobs** → add a new job set to every minute
|
|
(`* * * * *`). Command:
|
|
|
|
```
|
|
curl -s -H "x-cron-secret: <AUTOMATION_CRON_SECRET>" https://crm.example.com/api/automations/cron > /dev/null
|
|
```
|
|
|
|
Paste the literal secret — hPanel cron jobs don't inherit the Node app's
|
|
environment variables.
|
|
|
|
### Option B — external pinger
|
|
|
|
Any uptime monitor that supports custom headers works:
|
|
|
|
- [UptimeRobot](https://uptimerobot.com) — "Keyword Monitoring" with
|
|
custom HTTP headers.
|
|
- [Better Stack](https://betterstack.com).
|
|
- GitHub Actions with a `schedule:` trigger.
|
|
|
|
Hit the URL once per minute. Anything slower just means Wait-step
|
|
resolution is that much more delayed.
|
|
|
|
## 3. Verify
|
|
|
|
```bash
|
|
curl -s -H "x-cron-secret: <secret>" https://crm.example.com/api/automations/cron
|
|
# -> {"processed":0}
|
|
```
|
|
|
|
Then create a test automation with a short Wait step (e.g., 30 seconds)
|
|
and trigger it. Watch the automation's **Logs** tab — the execution
|
|
should resume and mark as completed within one cron interval of the wait
|
|
expiring.
|
|
|
|
## 4. What if you don't use Wait?
|
|
|
|
Skip this page. Trigger → inline steps → done flows do not need a cron —
|
|
they finish synchronously inside the webhook handler or from the UI. The
|
|
cron only matters for flows that park execution.
|