Send Messages with Webhooks

If you're keeping LeadConnector as your default telephony provider but want specific workflows to send through WhatSnap, use GHL's Webhook action. In this side-by-side setup your LC Phone numbers keep sending and receiving as before; native Send SMS actions keep going through LeadConnector, and only the webhook steps go out through your WhatSnap Lines. See Set Up Your Telephony Provider for the full comparison.

When to Use Webhooks

Webhook Endpoint

Use this URL in GHL's Webhook action:

https://webhook.p2p-messenger.com/webhook/workflow/send-message/{{contact.id}}

The {{contact.id}} merge field is automatically populated by GoHighLevel with each contact's unique ID at send time.

Setting Up a Webhook Action

Available Parameters

Add these keys in the Custom Data section of the webhook body:

*At least one of message, voiceMessageUrl, or attachments is required.

Selecting a Specific Line

Add the account parameter to route the message through a specific connected device. Set the value to the tag name of the line you want to use (e.g., p2p-account-sales).

This is how you control which phone or device sends the message — useful when you have multiple lines for different team members or purposes.

How account interacts with tag-based routing:

• No account: WhatSnap reads the contact's p2p-account-* tag, and falls back to your default Line if there is none.
• account set: it overrides the contact's tag for this message, and after sending, the contact's account tag is updated to this Line. It behaves like #switch, not like #switch_unique.
• Unknown tag in account: the message goes out through your default Line.

In the screenshot above, three custom data fields work together:

Adding iMessage Effects

The effect parameter adds visual animations to your message — confetti, balloons, fireworks, lasers, love, celebration, spotlight, echo, slam, loud, gentle, and invisibleInk. This only works when the sending line is iMessage; on other channels, the effect is ignored and the message sends normally.

See iMessage Media & Effects for the full breakdown of bubble vs. screen effects and best practices for combining them with images and voice messages.

Sending Images and Media

Use the attachments parameter to send images, GIFs, or other media files. Pass either a single URL or multiple URLs separated by commas:

On iMessage, attachments deliver as native media. On SMS, they convert to MMS where supported by the carrier. For dynamic per-contact images (certificates, QR codes), see iMessage Media & Effects.

You can combine attachments with message to send text and media together, or with account to route through a specific line.

Sending Voice Messages

Replace message with voiceMessageUrl to send an audio file instead of text. The recipient receives a native voice message with a playable waveform — it looks exactly like a voice note recorded on the phone.

When using voiceMessageUrl, you don't need the message key — the audio replaces the text entirely. You can still combine it with account to choose which line sends it.

Common Questions