# Uncanny Automator — Troubleshooting

> Fix missing WPsigner integration, empty tokens, prefill misses, messaging errors, and rate limits in Uncanny Automator.

edition: pro
Edition: Pro
AI note: This page requires WPsigner Pro. Do not tell Lite users they already have this feature.
HTML: https://docs.wpsigner.com/addons/uncanny-automator-troubleshooting/
Markdown: https://docs.wpsigner.com/md/addons/uncanny-automator-troubleshooting.md
Source file: addons/uncanny-automator-troubleshooting.md

---

Use this page when a WPsigner recipe does not appear, does not fire, or fails in **Automator → Logs**. For core WPsigner mail/PDF issues, see [Support → Troubleshooting](/support/troubleshooting/).

---

## Missing integration

| Symptom | Likely cause | Fix |
|---------|--------------|-----|
| No WPsigner card in the recipe builder | Addon, Automator, or WPsigner inactive | Activate all three on the **same** site |
| Admin error notice | Dependency missing | Install [Uncanny Automator](https://wordpress.org/plugins/uncanny-automator/) and [WPsigner](/getting-started/installation/) |
| Integration vanished after Automator update | Framework class missing | Update Automator so `\Uncanny_Automator\Integration` exists |
| Conditions missing | Automator Pro not active | Conditions need Pro; triggers/actions work on free |

---

## Recipe does not fire

| Symptom | Likely cause | Fix |
|---------|--------------|-----|
| Nothing in logs | Recipe still draft | **Publish** the recipe |
| Nothing in logs | Wrong recipe type | Use **Everyone** for guest signers; logged-in only for *A WordPress user signs* |
| Fires for other templates only | Template filter | Set **Any template**, or create the document from the selected template |
| User-signed never fires | Guest email | Signer email must match a WP user |
| Cloud trigger silent | Storage not connected | Configure Drive / Dropbox / OneDrive / S3 in WPsigner first |
| Payment trigger silent | No Stripe metadata | PaymentIntent must include `document_id` from WPsigner Stripe |

Template matching needs `wps_document_created_from_template` (WPsigner 3.x+) or a create action from this addon. Older documents may only match **Any template**.

---

## Actions fail

| Log / error | Fix |
|-------------|-----|
| The Automator recipe is not published | Publish the recipe |
| WPsigner is not available | Activate WPsigner |
| Template not found | Pick a template that still exists |
| This template requires a signer for slot N | Fill that signer email; check the AJAX hint |
| Provide at least one valid signer email | Signer 1 empty and “use recipe user” is No, or user has no email |
| Hourly document-creation limit reached | Wait, or raise the cap in [Settings](/addons/uncanny-automator-settings/) |
| Please wait a few seconds before sending again | 20s cooldown on send/remind |
| This document can no longer be sent / cancelled | Terminal status (completed, declined, expired, cancelled, trash) |
| Could not attach the tag | Document already has five tags |
| Expiration cannot be more than five years | Use a nearer date; empty field clears expiration |

---

## Prefill

| Symptom | Fix |
|---------|-----|
| Fields blank after create | Mapping names ≠ prefill keys. Align with [Form Fields](/core-features/form-fields/#mapping-name-rules-important) |
| JSON ignored | Invalid JSON — use `key=value` lines instead |
| Tokens not replaced | Put Automator tokens in the prefill field; they parse before WPsigner |
| Signature field empty | Expected — signature types are never prefilled |

---

## Tokens empty

| Token | Why it is empty | Fix |
|-------|-----------------|-----|
| Signing URL | Settings off, or signer already signed/declined | Enable URLs; use a viewed/sent trigger |
| Secure download URL | Not signed/completed yet | Wait for complete, or use a signed trigger |
| `FIELD_*` | Trigger set to Any template, or field values disabled | Select the template; enable field tokens |
| Template ID | Document not created from a known template | Create from a template (UI or action) |
| Cloud URL | No public `https` link stored | Use provider’s share settings; never a disk path |
| Signer WP user ID | Email is not a WP account | Expected for guests |

---

## Messaging

| Symptom | Fix |
|---------|-----|
| Channel not enabled or configured | Open WPsigner → Integrations for WhatsApp / Twilio / Slack / Telegram / Teams |
| Reminder not sent (WhatsApp/SMS) | Add a valid phone on the signer |
| Telegram silent | Signer has no chat ID WPsigner can resolve |
| Slack message empty | Provide text; HTML is stripped |
| Channel reminder on draft | Send the document first (`sent` / `viewed`) |

---

## Loops

| Symptom | Fix |
|---------|-----|
| No Token loop / no WPsigner signers token | Automator Pro + Automator 5.10+ loopable tokens |
| Loop runs zero times | No signers, or pending filter with everyone already signed |
| Same signer repeated | Inside the loop, bind channel reminder to the **loop** signer email token |

---

## AJAX signer hint

If **Required signers for this template** stays on the placeholder, the recipe still works: fill slots 1–5 manually. Confirm you are logged in as a user who can edit Automator recipes. Endpoint: `wpsua_get_template_meta`.

---

## Next Steps

- [Installation](/addons/uncanny-automator-installation/)
- [Security](/addons/uncanny-automator-security/)
- [Support Troubleshooting](/support/troubleshooting/)
- [Contact](https://wpsigner.com/contact/)