Welcome Wi-Fi visitors on their first connection

EffortNo-codeChannelWhatsApp + EmailPlanLite (paid)

First-time visitors to your Wi-Fi get a welcome on their phone while they're still at the counter, with their own name and a first-visit offer. Nobody has to press a button.

#What you'll get

• A welcome message that goes out on its own as soon as a visitor connects for the first time.
• One message per person: regulars who come back every day don't get the welcome again.
• The contact created or updated in the same call, with name, phone, email and the wifi tag.
• WhatsApp with an approved template, or email, depending on what your EasySpot asks for.
• Every send tracked on both sides: in the campaign stats in BIP and in the webhook logs in Easy Auth.

#How it works

1. 1Create an API Trigger campaign in BIP, in Immediate mode
2. 2Create an On Connect webhook in Easy Auth, once per user, that calls the campaign
3. 3Every new visitor gets the welcome right away

The integration from Connect Easy Auth to BIP brings in the contact, but it doesn't trigger campaigns. To respond the moment someone connects, you link both ends:

• in BIP, an API Trigger campaign in Immediate mode, which sends the message as soon as it receives the call;
• in Easy Auth, a second webhook, with the On Connect topic, that calls POST https://api.bip.marketing/api/campaigns/trigger with the campaign ID and the visitor's data. BIP creates or updates the contact and sends the message, all in the same call.

Two locks guarantee one message per person:

• in Easy Auth, Limit Calls per User set to Once per user: the webhook calls BIP only once for each visitor;
• in BIP, the Lead Re-entry Window turned off, which is the default: each contact gets the campaign once, ever.

#Step by step

#1. Create the API key for Easy Auth

1. In BIP, go to Settings, open the API Keys tab and click Add New API Key.
2. In Name, type Easy Auth — campaigns.
3. Leave Active on. Under Automatic Expiration, leave Enabled off, so the webhook never stops working on a set date.
4. Under Scopes, turn on Campaigns Trigger and Leads Write.
5. Click Save and copy the API key. You'll paste it into Easy Auth in step 6.

dash.bip.marketing/easyauth-…/settings?tab=api-keys

Screenshot coming soon

#2. Prepare the message

Choose the channel based on what your EasySpot asks for: phone for WhatsApp, email for email.

• WhatsApp: in WhatsApp, open the Templates tab and click Create template. Build the aurora_wifi_welcome template with the copy from Ready to copy, with Category set to Marketing and Language set to English (US). Click Save Template and wait for the Approved status.
• Email: in Emails Templates, click New Template and build the welcome email with the copy from Ready to copy. Click Save.

dash.bip.marketing/easyauth-…/whatsapp?tab=templates

Screenshot coming soon

#3. Create the API Trigger campaign

1. In Campaigns, click New Campaign. In Campaign Name, type Wi-Fi welcome.
2. Under Schedule Type, choose API Trigger and, under Trigger Mode, Immediate.
3. Under Lead Re-entry Window, leave Allow Lead Re-entry off. That's the default, and it's what you want: each contact gets the welcome once.
4. Under Channel, choose WhatsApp: select the approved Template and the Phone Number. Under Variable mappings, click Add variable mapping and link Body · {{1}} to first name. For email, choose Email, fill in the From Name (Padaria Aurora) and link the Email Template.
5. Open API Integration and copy the campaign ID. It's also at the end of the page URL.

dash.bip.marketing/easyauth-…/campaigns/…

Screenshot coming soon

#4. Test and activate the campaign

1. Click Save → Save Draft.
2. Click Test Campaign, enter your phone number (with + and the country code) or your email and click Send Test. You need to be a BIP contact, so connect to the Wi-Fi once first. Tests don't use up sends.
3. Check the message on your phone or in your inbox.
4. Click Save → Save and Activate and confirm in Activate API Trigger. The status changes to Active and the campaign starts accepting calls.

dash.bip.marketing/easyauth-…/campaigns/…

Screenshot coming soon

#5. Copy the body of the integration webhook

The webhook BIP created in Easy Auth already has the right variables for your EasySpot fields. You'll reuse that text.

1. Sign in to the Easy Auth Dashboard at app.easyauth.net and click Webhooks in the side menu.
2. On the webhook with the URL https://api.bip.marketing/api/leads, click Edit Webhook.
3. In Body, copy the lines inside the curly braces. The name, for example, comes as "name": "{{ field('field-name.value') }}".
4. Click Hide Edit Webhook without changing anything in that webhook.

app.easyauth.net

Screenshot coming soon

#6. Create the welcome webhook in Easy Auth

1. Click Add Webhook → Custom.
2. In Name, type Welcome → BIP. In Topic, choose On Connect. In Language, choose English.
3. In Limit Calls per User, choose Once per user.
4. In Method, leave POST. In URL, paste https://api.bip.marketing/api/campaigns/trigger.
5. If Trigger Tags shows up, leave all tags off: the webhook applies to every visitor.
6. Under Headers, click Add Header twice. Fill in Key Content-Type with Value application/json, and Key x-bip-api-key with the key from step 1.
7. In Body, delete the default text and paste the body from Ready to copy. Replace CAMPAIGN_ID with the ID from step 3 and, inside lead, use the lines you copied in step 5.

app.easyauth.net

Screenshot coming soon

#7. Test the webhook and save

1. Click Test Webhook.
2. In Load sample data, enter the phone number or email you already used to sign in to the Wi-Fi and click Load. The body shows your data in place of the variables.
3. Click Send Test. Under Response, status 200 and a Response Body with "mode": "immediate" show that BIP sent the message. It arrives on your phone or in your inbox.
4. Click Close. Make sure the webhook Status is on and click Save at the top of the page.

app.easyauth.net

Screenshot coming soon

#Ready to copy

#Webhook body

Padaria Aurora example: the EasySpot asks for name, phone (the license key) and email. Replace CAMPAIGN_ID with your campaign ID.

{
  "campaignId": "CAMPAIGN_ID",
  "lead": {
    "name": "{{ field('field-name.value') }}",
    "phone": "+{{ key('raw-full') }}",
    "email": "{{ field('field-email.value') }}",
    "tags": ["wifi"]
  }
}

Always use the lines from your integration body (step 5): they match your EasySpot fields. If your license key is the email, for example, the line comes as "email": "{{ key('value') }}". If the integration body includes the fields list (birthdate, city), paste the whole list inside lead to keep those fields up to date.

#Webhook in Easy Auth

#Campaign in BIP

#WhatsApp template

URL button: https://www.exemplo.com.br/cardapio

#Welcome email

Wherever you see [@first name], type @first, choose lead.firstName() and use friend as the Fallback Value.

[@first name], your first coffee is on us ☕

Thanks for using the Padaria Aurora Wi-Fi. Show this email at the register.

So glad you're here, [@first name]!

You just joined the Padaria Aurora Wi-Fi. Make yourself at home: fresh bread comes out of the oven from 7 a.m., every day.

To celebrate your first visit, your drip coffee is on us when you buy any savory snack. Just show this email at the register today.

See the menu

https://www.exemplo.com.br/cardapio

#How to measure

• In BIP: in Campaigns, open Campaign Stats for Wi-Fi welcome. For WhatsApp, track Sent, Delivered, Read Rate, Reply Rate and Errors. For email, Processed (N runs), Delivered, Open Rate and Click Rate.
• Who got it: in Recipient Interactions, each visitor shows up with a date and status. Rejected, with the reason Lead has already received this campaign, is a repeat call that BIP held back.
• In Easy Auth: in Webhooks, click View Logs. Each call to https://api.bip.marketing/api/campaigns/trigger shows up with Status, Topic, URL and Hour. In View Request, the Request Body shows the data sent, and the Response Body shows the leadId and the mode.
• New visitors: in Statistics → General tab, Easy Auth shows new and returning visitors for the period. Compare new visitors with the campaign's sends.
• At the register: count how many people showed the message to get their coffee.

If a log shows an error, the Response Body tells you why:

#Variations

• Only for non-subscribers (Easy Auth PRO): in the webhook, change the topic to On Connect Non-ISP. To give subscribers a different welcome, create another campaign and another webhook with On Connect ISP. See Lead and sales webhooks.
• Welcome a few minutes later: in the campaign, change Trigger Mode to Delay and fill in Delay (Seconds), for example 600. The message arrives ten minutes after the connection, once the customer is already seated.
• WhatsApp and email: each campaign uses one channel. Create one campaign per channel and, in Easy Auth, one webhook for each, with each campaign's campaignId in the body.
• Welcome-back offer for returning visitors: once the welcome is live, move on to Welcome back: today's offer for returning visitors.

#Frequently asked questions

#Why not use the webhook the integration already created?

Because it only sends the contact to BIP, at https://api.bip.marketing/api/leads, and doesn't trigger campaigns. Leave that webhook as it is, so every visitor keeps arriving in Leads, and create the welcome webhook next to it.

#Does the visitor get the welcome every time they connect?

No. In Easy Auth, Once per user makes the webhook call BIP once for each visitor. In BIP, with Allow Lead Re-entry off, each contact gets the campaign once. If a repeat call comes in, it shows up as Rejected in the stats and the message doesn't go out.

#Does the welcome use up sends?

Each message that goes out counts as one send for the month on BIP Lite. Creating and updating the contact doesn't count, and neither does a call that re-entry held back. Tests from Test Campaign don't use up sends; the webhook's Send Test does, because it's a real send.

#Can I send by WhatsApp and email at the same time?

Yes, with two campaigns: one for WhatsApp and one for email, each with its own webhook in Easy Auth. WhatsApp needs a paid plan and the visitor's phone number; email works on any plan, for visitors who gave their email in the EasySpot.

#See also

• Connect Easy Auth to BIP and receive your Wi-Fi visitors
• BIP API: keys, contacts, events and triggers
• Campaigns: one-time, recurring and API-triggered
• WhatsApp templates: create, sync and use
• Email editor: blocks, variables and preview
• Welcome back: today's offer for returning visitors
• Welcome use case on the BIP website
• Webhooks on the Easy Auth Wiki