The widget script needs to load globally so CTAs and embedded forms work everywhere they are used.
guide
Website Integration Instructions
Client-ready instructions for website providers installing TECOBI widget forms, embedded forms, SRP and VDP CTAs, and finance-related lead capture flows.
This guide gives website providers a clean TECOBI install path for widget-driven forms, embedded forms, inventory-page CTAs, and finance-related lead capture without losing consent tracking.
What this page covers
- Global widget installation
- SRP and VDP trigger classes
- Quick Qualify gating rules
- Embedded contact and finance forms
- Launch verification before go-live
Text-request flows should route through TECOBI so consent records and automated follow-up stay attached.
Quickly Qualify should only be added when the dealership's client ID email confirms the integration is active.
Quick start
Most website providers can get the TECOBI install right by following three decisions in order.
Step 1
Install the widget script globally.
Place the TECOBI widget script immediately before the closing body tag on every page so forms and triggers are available site-wide.
Step 2
Add the right CTA triggers.
Use Text Us on SRPs and VDPs by default, then add Quickly Qualify only when 700 Credit is active for that store.
Step 3
Use embeds where a full page flow makes more sense.
Contact, finance, and credit pages can use TECOBI embeds directly inside the page instead of relying only on widget-triggered buttons.
Section map
Jump to the part of the install your website team needs next.
The full instructions are below, but most provider questions fall into one of these setup areas.
Global widget install
Place the script once and make it available on every page.
SRP and VDP CTAsWire up customer-facing buttons on inventory and vehicle detail pages.
Trigger classesUse the correct class for Contact, Quick Qualify, and Full Credit.
Embedded formsDrop in the TECOBI embed when the form should live inside page content.
Recommended placementMatch the right TECOBI form or CTA pattern to the page type.
Launch checklistValidate client ID, form behavior, and lead capture before launch.
Placement guidance
Match the TECOBI form pattern to the page type instead of reusing the same CTA everywhere.
SRP pages
- Add a Text Us CTA.
- Add Quickly Qualify only if 700 Credit is active.
- Keep these near other primary customer actions.
VDP pages
- Place Text Us near standard lead actions.
- Use the same Quick Qualify rule as SRPs.
- Make sure inventory shoppers can enter TECOBI without extra navigation.
Finance and contact pages
- Use the Full Credit Application on finance-related pages.
- Use the Simple Contact Form on contact pages.
- Prefer embeds when a full-page conversion flow is more natural.
Launch standard
Before launch, verify the consent path and the TECOBI handoff, not just whether the button opens.
- Widget script installed once on every page
- CLIENT_ID replaced with the dealership-specific TECOBI client ID
- Text Us opens the Contact Form from SRPs and VDPs
- Quickly Qualify only appears when 700 Credit is active
- Full Credit Application works on finance-related pages
- Embedded forms render correctly on desktop and mobile
- Submitted test leads appear in TECOBI with the right source and consent record
Detailed instructions
Give the website provider a setup document that is clear enough to implement without guessing.
These are the same client-ready instructions, but structured for web reading and implementation review.
Instruction
1. Install the widget script on every page
Add the TECOBI widget script immediately before the closing body tag on every website page so the widget, CTA triggers, and embeds are available site-wide.
Do not install this on only one page. The script needs to be available globally so CTA buttons, SRP pages, VDP pages, and embedded form sections can all trigger TECOBI correctly.
Example markup
<!-- Include the TECOBI SMS Widget JavaScript just before </body> on ALL PAGES -->
<script
id="tecobi-widget-include"
src="https://widget.tecobi.com/widget.js?clientId=CLIENT_ID"></script>Instruction
2. Lead capture requirement
TECOBI forms should be the primary text-request path whenever the customer is asking to be contacted by text, quickly qualified, or moved into a finance flow.
- Use TECOBI widget forms or TECOBI embedded forms anywhere the customer is requesting contact by text.
- Avoid replacing TECOBI forms with native website forms unless those forms capture compliant SMS consent and pass the lead into TECOBI correctly.
- For the cleanest setup, website leads should flow through TECOBI first so automated follow-up can begin immediately and consent remains traceable.
Instruction
3. Required SRP and VDP CTA buttons
Search results pages and vehicle detail pages should surface the TECOBI conversion actions directly where inventory shoppers are already making contact decisions.
| CTA label | Button class | Purpose |
|---|---|---|
Text Us | tecobi-contact-us-toggle | Opens the TECOBI contact form in the widget. |
Quickly Qualify | tecobi-quick-qualify-toggle | Opens the TECOBI quick qualify form in the widget. |
Important
Quickly Qualify should only be installed when the dealership has the 700 Credit integration active. If the client ID email does not list 700 Credit as active, do not install the Quickly Qualify CTA or embed.
Instruction
4. Widget button triggers
Use these classes on buttons when the website should open a specific TECOBI form inside the widget.
| Action | Class to add |
|---|---|
| Open Contact Form | tecobi-contact-us-toggle |
| Open Quick Qualify Form | tecobi-quick-qualify-toggle |
| Open Full Credit Application | tecobi-full-credit-toggle |
Example markup
<button type="button" class="tecobi-contact-us-toggle">Text Us</button>
<button type="button" class="tecobi-quick-qualify-toggle">Quickly Qualify</button>
<button type="button" class="tecobi-full-credit-toggle">Apply for Financing</button> Important
Only use the Quickly Qualify trigger if the dealership's 700 Credit integration is active.
Instruction
5. Embedded form options
Use embedded forms when the dealership wants the TECOBI form placed directly inside the page layout instead of opened through the widget.
| Form | Embed code |
|---|---|
| Simple Contact Form | <div data-tecobi-embed="signup" style="width: 100%; height: 100%;"></div> |
| Quick Qualify, only if 700 Credit is active | <div data-tecobi-embed="quick-qualify" style="width: 100%; height: 100%;"></div> |
| Full Credit Application | <div data-tecobi-embed="full-credit-app" style="width: 100%; height: 100%;"></div> |
Instruction
6. Recommended placement
Use the TECOBI form type that matches the customer's context instead of forcing the same CTA pattern everywhere.
| Page or area | Recommended TECOBI integration |
|---|---|
| All pages | Global TECOBI widget script before </body>. |
| SRP pages | Text Us CTA, plus Quickly Qualify only if the client ID email says 700 Credit is active. |
| VDP pages | Text Us CTA near primary lead actions, plus Quickly Qualify only if the client ID email says 700 Credit is active. |
| Finance or credit pages | Full Credit Application embed or button trigger. |
| Contact pages | Simple Contact Form embed or Contact Form widget trigger. |
Instruction
7. Launch verification checklist
Before launch, confirm both the front-end behavior and the TECOBI-side lead record so the consent path is actually working end to end.
- The widget script is installed once on every page.
- CLIENT_ID has been replaced with the dealership's assigned TECOBI client ID.
- Text Us opens the Contact Form from SRPs and VDPs.
- If the client ID email indicates 700 Credit is active, Quickly Qualify opens the Quick Qualify form from SRPs and VDPs.
- If 700 Credit is not active, Quickly Qualify CTA and Quick Qualify embeds are not installed.
- Full Credit Application trigger or embed works on finance-related pages.
- Embedded forms display correctly on desktop and mobile.
- Submitted test leads appear in TECOBI with the correct source and consent record.
Final rule
Any customer request for text follow-up should flow through TECOBI whenever possible.
That keeps opt-in tracking intact, gives the dealership traceable consent records, and lets automated follow-up begin in the right workflow immediately.
Client ID email reference
The dealership's TECOBI client ID email is the source of truth.
Use it to confirm dealership-specific setup details, especially whether Quickly Qualify should be enabled through an active 700 Credit integration.