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

# Google Workspace Integration: Calendar, Sheets, and More

> Link Google Calendar, Sheets, Docs, and Forms to Soneka via OAuth. Book appointments in chat, trigger messages from spreadsheets, and generate documents.

Soneka's Google Workspace integration brings four of the most common business tools directly into your WhatsApp workflows. Connect your Google account once via OAuth and you can let customers book appointments through Calendar, trigger personalized WhatsApp messages from Sheets rows, generate contracts and proposals from Docs templates, and respond to Google Form submissions — all automatically, all in chat.

## Connect Your Google Account

<Steps>
  <Step title="Open Google Workspace Integration">
    In Soneka, go to **Settings → Integrations → Google Workspace** and click **Connect Google Account**.
  </Step>

  <Step title="Choose Your Google Account">
    A Google OAuth popup will open. Select the Google account (personal or Workspace) you want to connect to Soneka.
  </Step>

  <Step title="Review and Grant Permissions">
    Soneka requests access only to the specific Google products you use. Review each permission, then click **Allow**. You can grant access to individual products (Calendar, Sheets, Docs, Forms) and revoke any of them independently later.
  </Step>

  <Step title="Connection Confirmed">
    You'll be redirected back to Soneka with a **Connected** status. Individual product cards will show as active under the Google Workspace integration panel.
  </Step>
</Steps>

<Note>
  Soneka's use of Google API data complies with [Google's Limited Use requirements](https://developers.google.com/terms/api-services-user-data-policy). Data accessed via Google APIs is used only to provide the integration features described on this page and is never shared with third parties or used for advertising.
</Note>

***

## Google Calendar

Book appointments through WhatsApp conversations, automatically generate Google Meet links, and handle rescheduling and cancellations — all without leaving the chat.

### Booking Appointments in Chat

<Steps>
  <Step title="Create an Appointment Type">
    In Soneka, go to **Bookings → Appointment Types → New**. Set the name, duration, buffer time, and link it to a Google Calendar.
  </Step>

  <Step title="Share the Booking Link in Chat">
    In any conversation, use the **Book Appointment** quick reply or add a Booking action to a flow. Soneka sends an interactive availability picker to the customer inside WhatsApp.
  </Step>

  <Step title="Customer Selects a Slot">
    The customer picks a date and time from available slots (pulled live from your Google Calendar). Soneka creates the event, sends a confirmation message with all details, and adds both parties to the invite.
  </Step>
</Steps>

### Auto Google Meet Links

When **Video Meeting** is enabled on an appointment type, Soneka automatically generates a Google Meet link and includes it in the confirmation message sent to the customer. No manual link creation needed.

### Timezone Handling

Soneka detects the customer's timezone from their WhatsApp profile or from a timezone-selection step in your booking flow, and displays available times in their local timezone. The Calendar event is created with the correct UTC offset for both parties.

### Cancellations and Rescheduling

Customers can cancel or request a reschedule by replying to their confirmation message with a keyword (e.g., "cancel" or "reschedule"). Soneka will:

1. Delete or update the Google Calendar event.
2. Send a cancellation or new-slot confirmation to the customer.
3. Notify your team via a Soneka inbox alert.

***

## Google Sheets

Use Sheets as both a data source (to trigger WhatsApp messages) and a data destination (to export lead and conversation data).

### Import Contacts to Trigger Flows

<Steps>
  <Step title="Prepare Your Sheet">
    Create a Google Sheet with a header row. Include at minimum a `phone` column in E.164 format. Add any other columns (name, product, expiry date, etc.) you want to use as personalization variables.
  </Step>

  <Step title="Connect the Sheet in Soneka">
    Go to **Flows → New Flow → Trigger: Google Sheets Row Added** and authorize access to your Sheet. Map the column headers to Soneka contact fields and flow variables.
  </Step>

  <Step title="Define the Flow">
    Build the message sequence that fires when a new row is added. Reference column values as variables (e.g., `{{name}}`, `{{renewal_date}}`). Activate the flow and add rows to the Sheet to trigger messages.
  </Step>
</Steps>

<Tip>
  This approach works well for renewal reminders, event invitations, or any campaign where your team manages the contact list in a spreadsheet.
</Tip>

### Export Lead Data to Sheets

In **Reports → Export**, select **Export to Google Sheets** to push conversation summaries, lead capture form responses, or contact activity logs into a Sheet of your choice. Exports can be scheduled (daily, weekly) or triggered manually.

***

## Google Docs

Generate personalized documents — contracts, proposals, onboarding packs — from Docs templates and send them to customers directly in WhatsApp.

<Steps>
  <Step title="Create a Docs Template">
    In Google Docs, create your template document and mark dynamic fields using double-brace placeholders (e.g., `{{client_name}}`, `{{contract_value}}`, `{{start_date}}`).
  </Step>

  <Step title="Register the Template in Soneka">
    Go to **Integrations → Google Docs → New Template**, select the Docs file, and map each placeholder to a Soneka contact field or flow variable.
  </Step>

  <Step title="Add to a Flow or Send Manually">
    In a Flow, add a **Generate Document** action. Soneka fills the template with the contact's data, creates a new Doc in your Drive, and sends the shareable link (or a PDF export) in the WhatsApp conversation.
  </Step>
</Steps>

***

## Google Forms

Trigger personalized WhatsApp follow-up messages whenever a customer submits a Google Form — perfect for lead capture, event registration, or post-purchase surveys.

<Steps>
  <Step title="Connect Your Form">
    In Soneka, go to **Flows → New Flow → Trigger: Google Form Submission** and select the Form you want to monitor. Soneka links to the Form's response sheet to watch for new entries.
  </Step>

  <Step title="Map Form Fields">
    Map the form response columns (name, email, phone, answers) to Soneka variables. The phone number field is used to identify or create the WhatsApp contact.
  </Step>

  <Step title="Design the Follow-up Message">
    Build the message that fires on submission. Reference form answers as personalization variables (e.g., "Thanks for registering for `{{event_name}}`, `{{first_name}}`!"). Activate the flow.
  </Step>
</Steps>

***

## Revoking Access

To disconnect any Google product without removing the others, go to **Settings → Integrations → Google Workspace** and click **Revoke** next to the specific product (Calendar, Sheets, Docs, or Forms). To disconnect your entire Google account, click **Disconnect Google Account**. This does not delete any data already exported to your Drive or Sheets — it only removes Soneka's ongoing access.

<Warning>
  Revoking access will deactivate any live flows that depend on the disconnected Google product. Pause or update those flows before revoking to avoid interruptions.
</Warning>

You can also revoke access from Google's side at any time by visiting [myaccount.google.com/permissions](https://myaccount.google.com/permissions) and removing Soneka from the list of connected apps.