> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.tuco.ai/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Troubleshoot GoHighLevel → Tuco Message Delivery Issues (Message Not Sent, Follow-Up Skipped, Delayed, Queued)

Learn how to troubleshoot message delivery between GoHighLevel and Tuco. This guide explains how to use GoHighLevel Execution Logs and Tuco Activity Logs to determine why a message was sent, skipped, delayed, queued, deduplicated, or rescheduled.

👉 Prefer a plain checklist? See **[Why didn't my contact get a message?](https://docs.tuco.ai/troubleshooting/message-not-received)**

## Common Issues

### No phone number, or number in the wrong field

The **most common** reason a contact isn't messaged is that Tuco has no phone number it can read. Tuco reads the standard **`phone`** field. If the real number lives in a **custom GHL field** (e.g. “Mobile”, “Cell”, “Phone 2”), map that field to phone so Tuco imports it — otherwise the send fails with `missing_recipient`.

* Open the contact in Tuco and confirm a phone number is present.
* If it's blank, fix the field mapping and re-sync.

---

### Message Deduped

Tuco prevents accidental duplicate sends.

There are **two layers of deduplication**:

* **GoHighLevel** may cache identical requests within the same workflow execution.
* **Tuco** deduplicates identical messages sent to the same contact within a **24-hour window**.

If you're testing with a single contact:

* Change the message (e.g. **"Hi" → "Hey"**).
* If sending an attachment, upload a **new copy** instead of reusing the existing file.

You can upload new attachments at:

**https://app.tuco.ai/uploads**

---

### Line Offline

Occasionally Apple temporarily marks a Mac sender as inactive.

When this happens:

* Tuco automatically retries the message.
* The retry is visible in the **Activity Logs**.
* No manual action is usually required unless the line stays offline. If new/cold recipients stop delivering while existing conversations still work, see **[Line health & Apple restrictions](https://docs.tuco.ai/troubleshooting/line-health-and-restrictions)**.

---

### Daily Line Limit Reached

Each Tuco line can initiate conversations with **up to 50 new contacts per day**.

If this limit is reached:

* The message is automatically rescheduled (not dropped).
* It will be sent at **9:00 AM** the following day using your workspace timezone.

The default workspace timezone is **US Eastern Time**.

To change your workspace timezone:

**https://app.tuco.ai/settings**

---

### Missing Template Variable

A template variable used in your message is empty.

Example:

```
Hi {{name}}
```

If `{{name}}` does not exist for the contact, the message cannot be rendered correctly.

Verify that:

* The variable exists.
* The field contains a value.
* The variable name is spelled correctly.

---

## Still Having Issues?

Review:

* GoHighLevel Execution Logs
* Tuco Activity Logs
* Any error message shown in either system

# Troubleshoot GoHighLevel → Tuco Message Delivery Issues
#### 
1. Navigate to the "Execution logs" tab.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-16/898fb486-f5c1-4bf2-bd05-aecb4de2c548/sps-redacted-96057fe36af74be19edb8d839922699e_f0a4d62ca22b4626a17fbf15657adf13_text_export.jpeg)


2. Click "View details" for the specific workflow execution.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-16/235bdf9b-d478-4849-8aef-2f5100a8a236/sps-redacted-ee1077dfbb9e494a968d2d7b30978a54_438963ec0fa641fca8eae3944d74d63b_text_export.jpeg)


3. Review the "Event Status" and message details in the side panel.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-16/c0d8af79-8047-46e4-91eb-04ff9e80cb60/sps-redacted-f2e7050a5ad34f29bf5bbe96cb96b330_0592236239eb436cafc6e2638d8d07ba_text_export.jpeg)


4. Navigate to the Tuco AI dashboard.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-16/086c14dd-4f91-4feb-b6c3-026dc79fdbb1/sps-redacted-e882f09e07c84adcafd507f45c8c70d1_bd624951073d4ee4b58e1dddbd7c3a2a_text_export.jpeg)


5. Select the log entry for the skipped message.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-16/8fa720b8-4711-442b-b120-8d768a143552/sps-redacted-52563c026a794c85a035f99d7b4d1f70_d0d01060c0f24fa8ab9686bfae469d79_text_export.jpeg)


6. Select the log entry for the queued message.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-16/ffdaf96f-8d91-4fd7-ab02-832111a9204f/sps-redacted-25f38ea030b44266adca89b7337e9983_d24dd5ee826044a7828f7774b79e67ba_text_export.jpeg)
#### [Made by Tuco Support with Scribe](https://scribehow.com/o/Ob6D_ll6QeyWvoWpx5gSMA/viewer/Troubleshoot_GoHighLevel__Tuco_Message_Delivery_Issues__Dxy70laIS_CV09Kp64ktZQ)