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

# Workflow Troubleshoot

> Common solutions and troubleshooting steps for HubSpot workflow issues with Eazybe WhatsApp integration

## Overview

If your HubSpot workflows aren't sending WhatsApp messages as expected, this guide covers the most common issues and their solutions.

***

## 1. Email ID Registration Match

<Warning>
  The email address registered on your HubSpot account and your Eazybe account **must be the same** for workflows to function correctly.
</Warning>

<Steps>
  <Step title="Install Chrome Extension">
    Ensure the Eazybe Chrome extension is properly installed and active.

    <img src="https://mintcdn.com/eazybe/ETs8JxuG0iootOoz/images/1677063035.png?fit=max&auto=format&n=ETs8JxuG0iootOoz&q=85&s=41619e5a34b1d882d95ed0b1a595aaf7" alt="Chrome Extension" width="1918" height="916" data-path="images/1677063035.png" />
  </Step>

  <Step title="Integrate with HubSpot">
    Connect your HubSpot account through the Eazybe extension settings.

    <img src="https://mintcdn.com/eazybe/ETs8JxuG0iootOoz/images/1677287737.png?fit=max&auto=format&n=ETs8JxuG0iootOoz&q=85&s=14942761e6ef85e6bca042771f996bb0" alt="HubSpot Integration" width="1918" height="912" data-path="images/1677287737.png" />
  </Step>

  <Step title="Verify Email Addresses Match">
    Confirm that the email address used in HubSpot matches the one in your Eazybe account.

    <img src="https://mintcdn.com/eazybe/ETs8JxuG0iootOoz/images/1677287738.png?fit=max&auto=format&n=ETs8JxuG0iootOoz&q=85&s=61720abc224a8a7188863a637894fb9c" alt="Email Verification" width="1917" height="913" data-path="images/1677287738.png" />
  </Step>
</Steps>

***

## 2. Cloud Connection Requirement

<Info>
  The **cloud connection must be active** for successful message delivery when WhatsApp Web is offline.
</Info>

Ensure your cloud connection is enabled to allow workflows to send messages even when you're not actively using WhatsApp Web.

<img src="https://mintcdn.com/eazybe/ETs8JxuG0iootOoz/images/1677296011.png?fit=max&auto=format&n=ETs8JxuG0iootOoz&q=85&s=f0ac1aa0278a5496b8163911aadf944f" alt="Cloud Connection" width="1918" height="915" data-path="images/1677296011.png" />

***

## 3. Workflow Sender Identity

<Note>
  Messages are sent **from the contact owner's or deal owner's WhatsApp number**, regardless of which user created the workflow.
</Note>

This means:

* If John is the contact owner, messages go from John's WhatsApp
* The workflow creator's number is not used unless they own the contact/deal

<img src="https://mintcdn.com/eazybe/ETs8JxuG0iootOoz/images/1677289925.png?fit=max&auto=format&n=ETs8JxuG0iootOoz&q=85&s=e0afbe344ca427d2cf5d18f93429f19c" alt="Sender Identity" width="1918" height="912" data-path="images/1677289925.png" />

***

## 4. Failed Message Tracking

<Tip>
  Check the **scheduled labels in WhatsApp** to keep track of failed messages and identify delivery issues.
</Tip>

<img src="https://mintcdn.com/eazybe/ETs8JxuG0iootOoz/images/1677293365.png?fit=max&auto=format&n=ETs8JxuG0iootOoz&q=85&s=8bd29c1069f0a0307642fa7ab0c054e7" alt="Scheduled Labels" width="1918" height="912" data-path="images/1677293365.png" />

Use the scheduled labels feature to:

* Monitor pending messages
* Identify failed deliveries
* Retry failed messages manually if needed

***

## 5. Delivery Timing

<Info>
  It takes approximately **2 minutes** for scheduled messages to be delivered after a workflow trigger fires.
</Info>

<img src="https://mintcdn.com/eazybe/ETs8JxuG0iootOoz/images/1677294496.png?fit=max&auto=format&n=ETs8JxuG0iootOoz&q=85&s=0ef3f6ac4dafba1e77b21c2c2d3924e4" alt="Delivery Timing" width="1918" height="912" data-path="images/1677294496.png" />

If messages aren't appearing immediately:

* Wait at least 2-3 minutes after the trigger
* Check that the workflow was properly triggered in HubSpot
* Verify the contact meets all enrollment criteria

***

## 6. Multi-Device Duplication

<Warning>
  Duplicate messages occur when the **same account is active on more than one device** simultaneously.
</Warning>

<img src="https://mintcdn.com/eazybe/ETs8JxuG0iootOoz/images/1677297547.png?fit=max&auto=format&n=ETs8JxuG0iootOoz&q=85&s=db432b9e1e7b02e76ab4fb7f4b02876f" alt="Multi-Device Issue" width="1918" height="841" data-path="images/1677297547.png" />

To prevent duplicate sends:

<CardGroup cols={2}>
  <Card title="Use One Device" icon="mobile">
    Keep your WhatsApp account active on only one device at a time when running workflows.
  </Card>

  <Card title="Log Out Other Sessions" icon="right-from-bracket">
    Check WhatsApp Web's linked devices and remove any extra sessions.
  </Card>
</CardGroup>

<img src="https://mintcdn.com/eazybe/ETs8JxuG0iootOoz/images/1677300398.png?fit=max&auto=format&n=ETs8JxuG0iootOoz&q=85&s=3081ab915b52fe980ce3ce1a29c23a8a" alt="Device Management" width="1282" height="205" data-path="images/1677300398.png" />

***

## Need More Help?

<Card title="Contact Support" icon="envelope">
  If you're still experiencing issues, reach out to our support team at **[hey@eazybe.com](mailto:hey@eazybe.com)**
</Card>