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

# SendGrid koppelen

> Koppel SendGrid onder Apps en integraties met een API-sleutel, Afzender-e-mailadres en Afzendernaam, en mail je klanten vanuit je eigen SendGrid-account wanneer zendingen worden aangemaakt, verzonden, geannuleerd of een track & trace-update krijgen.

SendGrid stuurt je klant een e-mail wanneer er iets gebeurt met zijn zending, bijvoorbeeld wanneer het pakket onderweg is. De e-mail gaat uit vanuit je eigen SendGrid-account, vanaf je eigen adres, met een Dynamic Template die je in SendGrid ontwerpt. Zippendo vertelt SendGrid alleen welke gebeurtenis er heeft plaatsgevonden.

Integraties zijn inbegrepen bij elk abonnement. Testen, het afleverlog, bewerken en ontkoppelen werken voor elke app hetzelfde: zie [Een integratie koppelen](/docs/nl/how-to/connect-an-integration). De uitgebreidere handleiding is [SendGrid](/docs/nl/integrations/sendgrid).

## Voordat je begint

Je hebt het volgende nodig uit je SendGrid-account:

* **Een API-sleutel** die e-mail mag versturen. Maak die aan in SendGrid onder Settings → API Keys.
* **Een geverifieerde afzender**: het adres waarvan de e-mails komen moet in SendGrid zijn geverifieerd.
* **Een Dynamic Template voor elke gebeurtenis** waarover je een e-mail wilt sturen, bijvoorbeeld een voor "onderweg" en een voor track & trace-updates.

<Frame caption="De handleiding van SendGrid over API-sleutels">
  <img src="https://mintcdn.com/zippendo/9-sVHrvFOKqRvskN/images/how-to/connect-sendgrid/10-sendgrid-create-api-key.png?fit=max&auto=format&n=9-sVHrvFOKqRvskN&q=85&s=acb747a6f18dc37dd9053be105df31a8" alt="Documentatie van Twilio SendGrid over API-sleutels, met het pad Settings en API Keys" width="2880" height="2200" data-path="images/how-to/connect-sendgrid/10-sendgrid-create-api-key.png" />
</Frame>

<Warning>
  Het koppelvenster heeft geen veld voor het **Dynamic template-ID**. Een template-ID kan per gebeurtenis alleen via de Zippendo API worden ingesteld, dus vraag je ontwikkelaar of neem contact op met de support om het in te stellen. Zonder template voor een gebeurtenis heeft SendGrid geen e-mail om te versturen en weigert het de aflevering.
</Warning>

## SendGrid koppelen

<Steps>
  <Step title="Zoek SendGrid in de catalogus">
    Klik in de zijbalk op **Apps en integraties** en dan op **Catalogus**. SendGrid staat onder **Apps**. Klik op **Koppelen**, of op **Koppeling toevoegen** als je er al een hebt.
  </Step>

  <Step title="Bekijk de toegang">
    Lees wat Zippendo met de koppeling gaat doen en klik op **Doorgaan**.
  </Step>

  <Step title="Vul de gegevens van de koppeling in">
    Typ een **Naam koppeling**, zoals "Verzend-e-mails". Plak de sleutel in **API-sleutel** en vul dan **Afzender-e-mailadres** en **Afzendernaam** in.
  </Step>

  <Step title="Kies de gebeurtenissen">
    Vink de gebeurtenissen aan die een e-mail moeten versturen, of klik op **Alles selecteren**. Zie de lijst hieronder.
  </Step>

  <Step title="Klik op Koppelen">
    Je ziet **Integratie gekoppeld** en SendGrid staat op het tabblad **Gekoppeld**.
  </Step>
</Steps>

<Frame caption="De SendGrid-kaart in de catalogus">
  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-sendgrid/01-catalog-card-light.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=d107e45da496ce17716ebc664adff5b2" alt="Catalogus met de SendGrid-kaart en de knoppen Gebruiken in automatiseringen, Meer lezen en Koppelen" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-sendgrid/01-catalog-card-light.png" />

  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-sendgrid/01-catalog-card-dark.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=1f8f81f0e1eaee7f433d5b5b953cb3f0" alt="Catalogus met de SendGrid-kaart en de knoppen Gebruiken in automatiseringen, Meer lezen en Koppelen" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-sendgrid/01-catalog-card-dark.png" />
</Frame>

<Frame caption="SendGrid koppelen: een naam, API-sleutel, Afzender-e-mailadres en Afzendernaam">
  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-sendgrid/02-connect-modal-light.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=4f0666215affaba5c9a071fb68b37fda" alt="Koppelvenster voor SendGrid met een naam voor de koppeling, API-sleutel, Afzender-e-mailadres, Afzendernaam en selectievakjes voor gebeurtenissen" className="block dark:hidden" width="2880" height="2800" data-path="images/nl/how-to/connect-sendgrid/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-sendgrid/02-connect-modal-dark.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=b737681bf5382f1d921af829ac938ea4" alt="Koppelvenster voor SendGrid met een naam voor de koppeling, API-sleutel, Afzender-e-mailadres, Afzendernaam en selectievakjes voor gebeurtenissen" className="hidden dark:block" width="2880" height="2800" data-path="images/nl/how-to/connect-sendgrid/02-connect-modal-dark.png" />
</Frame>

| Veld | Verplicht | Wat je invult |
| - | - | - |
| **Naam koppeling** | Ja | Een naam die je herkent, maximaal 100 tekens. |
| **API-sleutel** | Ja | De SendGrid API-sleutel. Hij is verborgen terwijl je typt, wordt versleuteld opgeslagen en nooit meer getoond. |
| **Afzender-e-mailadres** | Ja | Het adres waarvan de e-mails komen. Het moet een afzender zijn die je in SendGrid hebt geverifieerd. |
| **Afzendernaam** | Ja | De naam die je klanten als afzender zien, zoals de naam van je webshop. |

## Gebeurtenissen waarover SendGrid een e-mail kan sturen

| Selectievakje | Verstuurd wanneer |
| - | - |
| **Zending aangemaakt** | Een zending wordt aangemaakt |
| **Zending verzonden** | Een zending wordt naar de vervoerder verzonden en heeft zijn verzendlabel |
| **Zending geannuleerd** | Een zending wordt geannuleerd of verwijderd |
| **Track & trace bijgewerkt** | De vervoerder meldt een nieuwe trackingscan |

SendGrid heeft geen bestelgebeurtenissen. Elke e-mail gaat naar het e-mailadres van de klant op de zending, met de template die voor die gebeurtenis is ingesteld.

<Frame caption="De zending- en trackinggebeurtenissen voor SendGrid">
  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-sendgrid/07-events-light.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=1de90d83dae73059862bdfc908a0cd91" alt="Koppelvenster van SendGrid, gescrolld naar de selectievakjes voor gebeurtenissen, inclusief Track & trace bijgewerkt" className="block dark:hidden" width="2880" height="2800" data-path="images/nl/how-to/connect-sendgrid/07-events-light.png" />

  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-sendgrid/07-events-dark.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=bdf5d36d431644e4d1bb2e328a1f9633" alt="Koppelvenster van SendGrid, gescrolld naar de selectievakjes voor gebeurtenissen, inclusief Track & trace bijgewerkt" className="hidden dark:block" width="2880" height="2800" data-path="images/nl/how-to/connect-sendgrid/07-events-dark.png" />
</Frame>

## Controleer de koppeling

Klik op het papieren vliegtuigje in de rij van de koppeling (**Testgebeurtenis verzenden**) en open dan het afleverlog (het stekkerpictogram). Een testgebeurtenis heeft geen klant en geen template, dus SendGrid weigert hem, ook als je gegevens juist zijn. De zekerste controle is een echte gebeurtenis voor een bestelling met het e-mailadres van een klant.

| Het afleverlog toont | Wat je kunt doen |
| - | - |
| 401 | SendGrid heeft de sleutel geweigerd. Maak een nieuwe sleutel aan en plak die in. |
| 403 | De sleutel mag geen e-mail versturen, of **Afzender-e-mailadres** is geen geverifieerde afzender in SendGrid. |
| 400 | SendGrid kon de e-mail niet opbouwen, bijvoorbeeld omdat de gebeurtenis geen template of geen e-mailadres van de klant heeft. Lees de reden van SendGrid in de foutmelding van de rij. |

<Frame caption="Een SendGrid-koppeling op het tabblad Gekoppeld">
  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-sendgrid/03-connected-light.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=c3c610c7ada2a2c22df3f613947c3805" alt="Tabblad Gekoppeld met een SendGrid-koppeling en de pictogrammen voor testen, afleverlog, bewerken en verwijderen" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-sendgrid/03-connected-light.png" />

  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-sendgrid/03-connected-dark.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=b58cbc2befeb6f7f33757ee5009329a6" alt="Tabblad Gekoppeld met een SendGrid-koppeling en de pictogrammen voor testen, afleverlog, bewerken en verwijderen" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-sendgrid/03-connected-dark.png" />
</Frame>

<Frame caption="Het afleverlog voor de eerste gebeurtenis">
  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-sendgrid/05-delivery-log-light.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=92bf681192613eb2e712106689071753" alt="Venster met het afleverlog van een SendGrid-koppeling met de tekst Nog geen afleveringen" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-sendgrid/05-delivery-log-light.png" />

  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-sendgrid/05-delivery-log-dark.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=c35fb11150597ec529e357d1102c7314" alt="Venster met het afleverlog van een SendGrid-koppeling met de tekst Nog geen afleveringen" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-sendgrid/05-delivery-log-dark.png" />
</Frame>

## De gegevens wijzigen of ontkoppelen

Klik op het schuifregelaarpictogram om **Je koppeling met SendGrid bewerken** te openen. Laat **API-sleutel**, **Afzender-e-mailadres** en **Afzendernaam** leeg om te behouden wat is opgeslagen. Wijzig je een ervan, vul dan alle drie in: wat je typt vervangt alles wat voor de koppeling is opgeslagen. Klik op **Wijzigingen opslaan**.

<Frame caption="Een SendGrid-koppeling bewerken">
  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-sendgrid/04-edit-modal-light.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=973079679a82e83cdf90a766d22cbb0a" alt="Bewerkvenster voor een SendGrid-koppeling met de naam van de koppeling, lege velden voor API-sleutel, Afzender-e-mailadres en Afzendernaam en de gebeurtenissen" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-sendgrid/04-edit-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-sendgrid/04-edit-modal-dark.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=b14ceeaf0d4e8c72f6655cdc0ecc8621" alt="Bewerkvenster voor een SendGrid-koppeling met de naam van de koppeling, lege velden voor API-sleutel, Afzender-e-mailadres en Afzendernaam en de gebeurtenissen" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-sendgrid/04-edit-modal-dark.png" />
</Frame>

Om te ontkoppelen klik je op de prullenbak, typ je DELETE en klik je op **Ontkoppelen**. Zippendo stopt met het versturen van gebeurtenissen naar SendGrid en verwijdert het afleverlog.

<Frame caption="Typ DELETE om te ontkoppelen">
  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-sendgrid/06-disconnect-modal-light.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=f9d5d9ff592a089719be40916151cdcf" alt="Venster Integratie ontkoppelen dat vraagt om DELETE te typen" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-sendgrid/06-disconnect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-sendgrid/06-disconnect-modal-dark.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=5ae4fbdd7425c60834d10b34d27bd14f" alt="Venster Integratie ontkoppelen dat vraagt om DELETE te typen" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-sendgrid/06-disconnect-modal-dark.png" />
</Frame>

## SendGrid gebruiken in een automatisering

Voeg in **Automatiseringen** de stap **SendGrid-e-mail verzenden** toe. Die verstuurt de e-mail voor de gebeurtenis die de automatisering heeft gestart, maar alleen als je voorwaarden overeenkomen, bijvoorbeeld alleen voor zendingen naar het buitenland. Hij gebruikt dezelfde template als de koppeling voor die gebeurtenis.

| Veld | Verplicht | Wat het doet |
| - | - | - |
| **Koppeling** | Ja | Kies je SendGrid-koppeling uit de lijst. Zonder koppeling zie je **Koppeling is verplicht**. |
| **Eigen eigenschappen** | Nee | Klik op **Toevoegen** om extra gegevens naar de template te sturen, zoals de referentie van de zending. |

Zie [Automatiseringen](/docs/nl/how-to/automations) om de rest van de automatisering te bouwen.

## Gerelateerd

* [Een integratie koppelen](/docs/nl/how-to/connect-an-integration) - testen, afleverlog, bewerken en ontkoppelen voor elke app
* [SendGrid](/docs/nl/integrations/sendgrid) - de uitgebreidere handleiding
* [Problemen met integraties oplossen](/docs/nl/integrations/troubleshooting)
* [Automatiseringen](/docs/nl/how-to/automations)
* [Een vervoerder of integratie koppelen](/docs/nl/how-to/connect-index)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.