> For the complete documentation index, see [llms.txt](https://docs.adpage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adpage.io/data-and-insights/data-and-insights-nl/marketingintegraties/zoho-crm.md).

# Zoho CRM

Koppel Zoho CRM zodat deals die een fase bereiken die jij kiest, zoals Kwalificatie, Voorstel/Prijsopgave of Gesloten gewonnen, naar Google Ads kunnen gaan als offline conversies.

Verbind Zoho CRM zodat AdPage de deals kan zien waar je salesteam buiten de website aan werkt. Met **Offline conversies** aan **Data boosts**, gaat een deal die een fase bereikt die jij kiest (*Kwalificatie*, *Voorstel/prijsofferte* of *Gesloten gewonnen*, bijvoorbeeld) naar Google Ads als conversie. Google Ads leert dan welke klikken echte klanten hebben opgeleverd, niet alleen welke klikken een formulier hebben ingevuld.

AdPage leest alleen: het kan geen deal of contact aanmaken, wijzigen of verwijderen, en er wordt nooit iets teruggeschreven naar Zoho.

{% hint style="info" %}
**Zoho CRM maakt deel uit van Offline conversies, wat in een pilot zit.** De tegel verschijnt alleen voor accounts waarvoor deze is ingeschakeld. Zie je hem niet, vraag dan <support@adpage.io> om hem in te schakelen.
{% endhint %}

De screenshots op deze pagina tonen een fictieve winkel, met de app in het Nederlands.

### Voordat je begint

Degene die verbinding maakt, heeft tegelijk twee dingen nodig:

* Een **AdPage-login met toegang tot de container** waar de deals bij horen. De verbinding wordt per container opgeslagen, en een container koppelt aan één Zoho CRM-organisatie. Als je later een andere organisatie koppelt, vervangt die de eerste.
* Een **Zoho CRM-gebruiker die de deals kan zien** die mee moeten. AdPage leest met de rechten van de gebruiker die verbindt: een deal of contact dat die gebruiker in Zoho niet kan zien, kan AdPage ook niet zien. Verbind als beheerder, of als een gebruiker wiens rol en profiel toegang geven tot elke deal in de pipelines die je wilt gebruiken.

Elk Zoho-datacenter werkt: zoho.com, zoho.eu, zoho.in, zoho.com.au en de andere. Je meldt je aan op Zoho's eigen pagina, en Zoho vertelt AdPage waar je account zich bevindt.

AdPage vraagt Zoho om vijf rechten, allemaal alleen-lezen:

| Machtiging in Zoho              | Wat AdPage ermee doet                                                                                              |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `ZohoCRM.modules.deals.READ`    | Leest de deals die in de periode zijn gewijzigd en hun fasegeschiedenis: wanneer een deal welke fase heeft bereikt |
| `ZohoCRM.modules.contacts.READ` | Leest het contact bij zo'n deal, zodat Google de conversie kan koppelen aan een advertentieklik                    |
| `ZohoCRM.settings.fields.READ`  | Leest je pipelines en fasen waaruit je kunt kiezen, en welke dealvelden je organisatie heeft                       |
| `ZohoCRM.org.READ`              | Leest de naam en valuta van je organisatie                                                                         |
| `ZohoCRM.users.READ`            | Toont welke Zoho-gebruiker de verbinding heeft gemaakt                                                             |

Niets anders: geen toegang tot e-mails, notities, gesprekken, offertes, facturen, accounts (bedrijven) of bestanden, en geen schrijftoegang tot iets.

### Zoho CRM verbinden

{% stepper %}
{% step %}

#### De tegel openen

Ga naar **Koppelingen** en selecteer de container bovenaan de pagina. Open daarna de **Zoho CRM** tegel in de e-mail- en levenscyclusgroep. Zoeken naar "zoho", "crm" of "deals" vindt hem ook.

<figure><img src="https://data.adpage.io/help/offline-conversies/11-zoho-koppelen.png" alt="The Zoho CRM tile on Integrations, before connecting"><figcaption><p>De Zoho CRM-tegel, vóór het verbinden</p></figcaption></figure>
{% endstep %}

{% step %}

#### Verbinden

Selecteer **Zoho CRM verbinden**. Je wordt naar Zoho gestuurd om in te loggen. Meld je aan met de Zoho-gebruiker die de deals kan zien.
{% endstep %}

{% step %}

#### Accepteer AdPage in Zoho

Zoho toont de naam van de app, **AdPage**, en de bovenstaande machtigingen. Selecteer **Accepteren**.
{% endstep %}

{% step %}

#### Terug in AdPage

Je keert terug naar **Koppelingen**. De tegel toont je Zoho CRM-organisatie (de naam en ID), het datacenter (bijvoorbeeld zoho.eu) en de Zoho-gebruiker die hem heeft gekoppeld. Controleer of dit de organisatie is waarin je deals staan.

<figure><img src="https://data.adpage.io/help/offline-conversies/12-zoho-gekoppeld.png" alt="The Zoho CRM tile after connecting, with the organization, data center and user"><figcaption><p>Verbonden: de organisatie, het datacenter en wie heeft verbonden</p></figcaption></figure>
{% endstep %}
{% endstepper %}

### Wat je krijgt

Zoho CRM toont zelf niets in Data Studio. Het is een bron voor **Offline conversies**. Ga naar **Data boosts**, open het **Boosts** tabblad en open **Offline conversies**. Selecteer dan **Nieuwe flow**, kies **Deals uit Zoho CRM die een fase bereiken** en selecteer **Aanmaken**.

<figure><img src="https://data.adpage.io/help/offline-conversies/13-zoho-nieuw.png" alt="Choosing Zoho CRM as the source of a new flow"><figcaption><p>Zoho CRM als bron van een nieuwe flow</p></figcaption></figure>

Onder **Flow**, kies de **Pipeline** en de **Fase die de deal bereikt**, bijvoorbeeld *Voorstel/prijsofferte* of *Gesloten gewonnen*. De fasen dragen de namen die je in Zoho gebruikt. Gebruik je geen pipelines in Zoho? Dan is er één keuze, **Alle deals**, en die is al geselecteerd.

<figure><img src="https://data.adpage.io/help/offline-conversies/14-zoho-fase.png" alt="Pipeline and stage of a Zoho CRM flow"><figcaption><p>Zoho CRM: de pipeline en de fase die als conversie telt</p></figcaption></figure>

Daarna, in de flow:

* **Wat meegaat**: regels op het dealbedrag, het dealtype, de leadbron, de eigenaar (op naam), of het contact een e-mailadres heeft. Brent, naast de regels, kan ze in gewone woorden voor je instellen, bijvoorbeeld "Alleen deals met leadbron Google AdWords" of "Alleen deals boven 1.000 euro". Wijzigingen blijven een concept totdat je **Opslaan**.
* **Waarde en matching**: de conversiewaarde is het bedrag van de deal, in de valuta van de deal of anders die van je organisatie. Google koppelt op basis van het e-mailadres, altijd gehasht; het telefoonnummer en de naam en het adres kunnen ook worden toegevoegd, eveneens gehasht. Kies waarop het delen met Google is gebaseerd: zonder basis gaat er niets naar Google, zelfs niet voor een controle.
* **Aan welk Google Ads-account**: een Google Ads-account en een conversieactie per pipeline. AdPage kan de conversieactie voor je aanmaken, als een secundaire importactie.
* **Proefdraaien**: wat er over een periode van maximaal 31 dagen zou meegaan. Er gaat niets naar Google.
* **Laat Google het controleren**: Google controleert de login, het account, de conversieactie en de gegevens van de laatste proefdraaibeurt, zonder iets vast te leggen.

De [Offline conversies](https://docs.adpage.io/data-and-insights/data-and-insights-nl/marketingintegraties/offline-conversions.md) pagina loopt met screenshots door elk van deze stappen.

Zodra het proefdraaien en de controle door Google in orde zijn, zet AdPage de flow tijdens de pilot voor je aan. Vanaf dan gaan elk uur de deals die sinds de vorige run de fase hebben bereikt naar Google Ads. Niets van vóór het moment waarop het is ingeschakeld, gaat mee.

### Welke fase je kiest

De fase is waar Google Ads op leert bieden, dus kies het moment dat voor jouw bedrijf betekent: "dit was een goede lead":

* **Een vroege fase**, zoals *Kwalificatie*, geeft Google meer conversies en snellere feedback, maar omvat leads die nooit kopen.
* **Een late fase**, zoals *Gesloten gewonnen*, is het sterkste signaal, maar er zijn er minder van en ze komen later. Een deal die lang na de klik sluit, valt mogelijk buiten het klikvenster van de conversieactie in Google Ads.

Je kunt meer dan één flow maken, bijvoorbeeld één voor *Voorstel/prijsofferte* en één voor *Gesloten gewonnen*, elk met zijn eigen conversieactie. Bepaal vervolgens in Google Ads op welke van de twee je bieding is gebaseerd.

### Wat AdPage uit Zoho CRM leest

Zolang een flow niet is ingeschakeld, leest AdPage alleen Zoho terwijl je aan een flow werkt: om je pipelines en fasen te tonen, en wanneer je een proefdraaibeurt doet of Google het laat controleren. Zodra een flow aan staat, leest het elk uur hetzelfde, voor de deals die zijn gewijzigd sinds de vorige run. Het leest:

* de deals die zijn gewijzigd sinds het begin van de periode: fase, pipeline, bedrag, valuta, type, leadbron, eigenaar, het gekoppelde contact, en wanneer de deal is aangemaakt en voor het laatst gewijzigd;
* voor die deals in je pipeline, hun **fasegeschiedenis**: welke fase ze hebben bereikt, en wanneer;
* van het contact in het veld **Contactnaam**: e-mailadres (of secundair e-mailadres), telefoon- of mobiele nummer, voor- en achternaam, straatnaam voor post, postcode, stad en land.

Geen van die klantgegevens wordt bij de flow opgeslagen. Een proefdraaibeurt bewaart aantallen, dealnummers, data en waarden, en welke waarden voorkomen in de regelfel­den (zoals je leadbronnen), zodat je ze in een regel kunt kiezen. Er worden geen namen, e-mailadressen of telefoonnummers bewaard. Wat ook naar Google gaat, wordt eerst gehasht (SHA-256), zoals Google vereist.

### De cijfers lezen

**De conversietijd is het eerste moment waarop de deal de fase bereikte**, genomen uit de fasegeschiedenis. Een deal die teruggaat en de fase opnieuw binnengaat, telt één keer. Een deal die de fase heeft gepasseerd en verder is gegaan, bijvoorbeeld van *Voorstel/prijsofferte* naar *Gesloten gewonnen*, telt nog steeds mee voor de eerdere fase.

**Alleen het contact in het veld Contactnaam van de deal telt mee.** Een deal zonder contact, of waarvan het contact geen e-mailadres heeft, geeft Google niets om op te matchen. De proefdraaibeurt telt die als **Zonder e-mailadres**.

**Een telefoonnummer zonder landcode (zoals 06 12345678) helpt alleen als het contact een land**, bijvoorbeeld *Nederland*, *Nederland* of *NL*.

**De waarde is het dealbedrag zoals ingevuld in Zoho.** Een deal in Zoho heeft geen btw, dus of de waarde btw bevat hangt ervan af hoe je team het bedrag invult.

**Een proefdraaibeurt gebruikt Zoho-APIcredits.** AdPage leest de fasegeschiedenis van elke deal die in de periode is gewijzigd, één verzoek per deal. Een proefdraaibeurt over een maand met veel gewijzigde deals gebruikt een paar honderd van je dagelijkse Zoho-credits. Er worden maximaal 500 deals per proefdraaibeurt gelezen; bij meer zegt de proefdraaibeurt dat slechts een deel van de deals wordt getoond. Kies een kortere periode.

### Problemen oplossen

**De Zoho CRM-tegel ontbreekt.** Offline conversies wordt per klant ingeschakeld; zie de opmerking bovenaan deze pagina.

**Je komt met een fout terug op Integrations.** De toestemming is geannuleerd of niet voltooid. Selecteer **Zoho CRM verbinden** opnieuw. Zegt de fout dat Zoho je heeft teruggestuurd vanuit een datacenter dat AdPage niet herkent? Neem dan contact op met <support@adpage.io>.

**De tegel zegt Toegang verlopen.** AdPage is verwijderd uit de gekoppelde apps van de Zoho-gebruiker, of die gebruiker heeft geen toegang meer tot Zoho CRM. Selecteer **Opnieuw verbinden**, bij voorkeur als een Zoho-gebruiker die bij het bedrijf blijft.

**Een flow kan de pipelines en fasen niet laden.** Meestal is de verbinding verlopen: controleer de Zoho CRM-tegel onder **Koppelingen**.

**De proefdraaibeurt vraagt je de pipeline en fase te kiezen, terwijl je dat deed.** De fase is in Zoho hernoemd of verwijderd. Kies de fase opnieuw.

**Verwachte deals ontbreken.** De Zoho-gebruiker die heeft verbonden kan ze niet zien (zijn rol of deelregels), of ze zitten in een andere pipeline. Verbind opnieuw als een gebruiker die elke deal ziet.

**Verbinding verbreken.** Selecteer **Verbinding verbreken** in de tegel. AdPage trekt zijn toegang bij Zoho in en verwijdert zijn kopie ervan. Flows met Zoho CRM als bron stoppen met alles te lezen. Je kunt AdPage ook in Zoho zelf verwijderen, via de gekoppelde apps van je Zoho-account.

{% hint style="warning" %}
**Zoho CRM valt niet onder de dagelijkse verbindingscontrole**, dus een verbroken verbinding e-mailt je niet. Als je gebruikers of machtigingen in Zoho wijzigt, controleer de tegel daarna.
{% endhint %}

Nog steeds vastgelopen? Neem contact op met <support@adpage.io> en vermeld de container en wat de tegel toonde.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.adpage.io/data-and-insights/data-and-insights-nl/marketingintegraties/zoho-crm.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
