Zoho

    Hieronder staat een stap-voor-stap handleiding om een webhook in Zoho in te stellen die een JSON-payload verstuurt naar de API van Print.one.

    Voorbereiding

    1. Zoho-account

      Zorg ervoor dat je toegang hebt tot je Zoho-account en de juiste Zoho-app (bijvoorbeeld Zoho CRM, Zoho Creator, of Zoho Desk).

    2. Print.one API-sleutel

      Verkrijg je API-key van Print.one. Zorg ervoor dat je een TEST API-sleutel gebruikt voor de testfase en de LIVE API-sleutel wanneer je echt gaat versturen.

    Stap 1: Log in op Zoho

    1. Ga naar Zoho en log in met je account.

    Stap 2: Kies de juiste Zoho-app

    1. Selecteer de Zoho-app waarin je de webhook wilt instellen. Bijvoorbeeld:

      • Zoho CRM

        voor lead- of dealinformatie.

      • Zoho Creator

        voor aangepaste formulieren.

      • Zoho Desk

        voor ticketinformatie.

    In dit voorbeeld gaan we ervan uit dat je Zoho CRM gebruikt, maar het proces is vergelijkbaar voor andere Zoho-apps.

    Stap 3: Ga naar Instellingen

    1. Klik op het Instellingen-icoon (tandwiel) in de rechterbovenhoek.

    2. Zoek de optie "Webhooks" onder Automatisering of Integraties.

      • Voor Zoho CRM: Ga naar Instellingen → Automatisering → Webhooks.

      • Voor Zoho Desk: Ga naar Instellingen → Automatisering → Webhooks

    Stap 4: Maak een nieuwe Webhook aan

    1. Klik op de knop "Nieuw Webhook" (of "Create Webhook").

    2. Vul de volgende velden in:

      • Webhooknaam

        Geef de webhook een naam, bijvoorbeeld “Verstuur naar Print.one API”.

      • URL to notify

        Voer de volgende URL in: https://api.print.one/v2/orders

      • HTTP-methode

        Selecteer POST

    Stap 5: Voeg de Headers toe

    1. Voeg de header X-API-KEY toe, die je API-sleutel bevat. Dit is hoe je de header instelt:

      • Key: X-API-KEY

      • Value: Voer hier je Print.one API-key in, deze vind je in de Print.one portal onder Integrate > API keys

    2. Voeg de Content-Type header toe:

      • Key: Content-Type

      • Value: application/json

    Stap 6: Stel de JSON Payload in

    1. Je moet de gegevens configureren die je naar Print.one wilt sturen. De API van Print.one verwacht een JSON-payload die de bestellingsinformatie bevat.

    2. In Zoho kun je dynamische velden gebruiken (bijvoorbeeld gegevens uit een lead, ticket of een ander object). Stel de JSON-payload in zoals hieronder:

    JSON code voorbeeld voor Zoho
    1{
    2  "sender": {
    3    "name": "Your Name",
    4    "address": "Street 123",
    5    "postalCode": "1234AB",
    6    "city": "Amsterdam",
    7    "country": "Netherlands"
    8  },
    9  "recipient": {
    10    "name": "{{Field_Name}}",
    11    "address": "{{Field_Name}}",
    12    "postalCode": "{{Field_Name}}",
    13    "city": "{{Field_Name}}",
    14    "country": "{{Field_Name}}"
    15  },
    16  "mergeVariables": {
    17    "firstname": "{{Field_Name}}",
    18    "discount": "{{Field_Name}}",
    19    "couponcode": "{{Field_Name}}"
    20  },
    21  "templateId": "tmpl_1234567890987654321",
    22  "finish": "GLOSSY",
    23  "billingId": "Your attribute or campaign name for cost allocation"
    24}

    • Let op: vervang {{Field_Name}} overal door de werkelijke veldnamen in Zoho

    Stap 7: Voeg de webhook toe aan een workflow

    1. Als je wilt dat de webhook automatisch wordt geactiveerd (bijvoorbeeld wanneer een lead wordt aangemaakt), voeg deze dan toe aan een workflow.

    2. Ga naar Instellingen → Automatisering → Workflows.

    3. Maak een nieuwe workflow aan of bewerk een bestaande.

    4. Voeg de actie Webhook toe aan de workflow:

      • Selecteer de zojuist gemaakte webhook.

      • Configureer eventuele extra voorwaarden, zoals wanneer de workflow moet worden geactiveerd (bijvoorbeeld bij het creëren van een nieuwe lead of deal).

    Stap 8: Test de webhook

    1. Nadat je de webhook hebt ingesteld, is het belangrijk om deze te testen.

    2. Maak een testrecord in Zoho (bijvoorbeeld een nieuwe lead) die de workflow activeert.

    3. Controleer in Print.one of de bestelling correct wordt ontvangen. Als je order de status failed heeft, kijk dan bij de orderdetails wat de foutmelding is.

    4. Als je een TEST API-sleutel hebt gebruikt, wordt je bestelling niet gedrukt of verzonden, er wordt enkel een pdf aangemaakt. Gebruik je de LIVE API key dan wordt je order gedrukt en verstuurd.

    Stap 9: Probleemoplossing

    Als de webhook niet werkt zoals verwacht, controleer dan de volgende zaken:

    • API-sleutel: Is de X-API-KEY header correct ingesteld met de juiste API-sleutel (TEST voor testen, LIVE voor productie)?

    • JSON Payload: Is de structuur van de JSON correct en bevat het de juiste gegevens? Zijn alle merge variabelen die je gebruikt hebt in je design aanwezig in de JSON payload?

    • URL: Is de URL https://api.print.one/v2/orders correct ingesteld?

    • Content-Type: Is de header Content-Type: application/json juist ingesteld?

    • Workflow: Werkt de workflow zoals verwacht? Zorg ervoor dat de webhook wordt geactiveerd op de juiste gebeurtenis (bijvoorbeeld wanneer een lead wordt gemaakt).

    Stap 10: Gebruik de LIVE API-sleutel voor productie

    1. Zodra je hebt bevestigd dat de webhook goed werkt met de TEST API-sleutel, kun je overschakelen naar de LIVE API-sleutel van Print.one om bestellingen daadwerkelijk te versturen.

    2. Vervang de TEST-API-sleutel in de header met je LIVE-API-sleutel en voer de test opnieuw uit.