> ## 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.

# Yhdistä SendGrid

> Yhdistä SendGrid kohdassa Sovellukset ja integraatiot API-avaimella, Lähettäjän sähköpostilla ja Lähettäjän nimellä ja lähetä asiakkaillesi sähköposteja omalta SendGrid-tililtäsi, kun lähetyksiä luodaan, lähetetään, peruutetaan tai niiden seuranta päivittyy.

SendGrid lähettää asiakkaallesi sähköpostin, kun hänen lähetykselleen tapahtuu jotakin, esimerkiksi kun paketti on matkalla. Sähköposti lähtee omalta SendGrid-tililtäsi, omasta osoitteestasi, SendGridissä suunnittelemasi Dynamic Templaten avulla. Zippendo kertoo SendGridille vain, mikä tapahtuma tapahtui.

Integraatiot sisältyvät jokaiseen pakettiin. Testaus, toimituslogi, muokkaus ja yhteyden katkaiseminen toimivat samoin jokaisessa sovelluksessa: katso [Yhdistä integraatio](/docs/fi/how-to/connect-an-integration). Pidempi opas on [SendGrid](/docs/fi/integrations/sendgrid).

## Ennen kuin aloitat

Tarvitset SendGrid-tililtäsi:

* **API-avaimen**, jolla on lupa lähettää sähköpostia. Luo se SendGridissä kohdassa Settings → API Keys.
* **Vahvistetun lähettäjän**: osoite, josta sähköpostit lähtevät, on vahvistettava SendGridissä.
* **Dynamic Templaten jokaiselle tapahtumalle**, josta haluat lähettää sähköpostia, esimerkiksi yhden tilalle "matkalla" ja yhden seurantapäivityksille.

<Frame caption="SendGridin opas API-avaimiin">
  <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="Twilio SendGridin API-avainten dokumentaatio, jossa näkyy polku Settings ja API Keys" width="2880" height="2200" data-path="images/how-to/connect-sendgrid/10-sendgrid-create-api-key.png" />
</Frame>

<Warning>
  Yhteysikkunassa ei ole kenttää **Dynamic template ID** -tunnukselle. Mallin tunnuksen voi asettaa kullekin tapahtumalle vain Zippendon API:n kautta, joten pyydä kehittäjääsi tai ota yhteyttä tukeen sen asettamiseksi. Ilman mallia tapahtumalle SendGridillä ei ole lähetettävää sähköpostia, ja se hylkää toimituksen.
</Warning>

## Yhdistä SendGrid

<Steps>
  <Step title="Etsi SendGrid katalogista">
    Valitse sivupalkista **Sovellukset ja integraatiot** ja sitten **Katalogi**. SendGrid on kohdassa **Sovellukset**. Valitse **Yhdistä** tai **Lisää yhteys**, jos sinulla on jo yksi.
  </Step>

  <Step title="Tarkista käyttöoikeudet">
    Lue, mitä Zippendo tekee yhteydellä, ja valitse **Jatka**.
  </Step>

  <Step title="Täytä yhteyden tiedot">
    Kirjoita **Yhteyden nimi**, esimerkiksi "Toimitussähköpostit". Liitä avain kenttään **API-avain** ja täytä sitten **Lähettäjän sähköposti** ja **Lähettäjän nimi**.
  </Step>

  <Step title="Valitse tapahtumat">
    Valitse tapahtumat, joista pitää lähettää sähköposti, tai valitse **Valitse kaikki**. Katso alla oleva luettelo.
  </Step>

  <Step title="Valitse Yhdistä">
    Näet viestin **Integraatio yhdistetty**, ja SendGrid näkyy **Yhdistetty**-välilehdellä.
  </Step>
</Steps>

<Frame caption="SendGrid-kortti katalogissa">
  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-sendgrid/01-catalog-card-light.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=a89384185fe1346cf68ed3409ec0bf6a" alt="Katalogi, jossa SendGrid-kortti ja sen painikkeet Käytä automaatioissa, Lue lisää ja Yhdistä" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-sendgrid/01-catalog-card-light.png" />

  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-sendgrid/01-catalog-card-dark.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=4af4b15f1b2949a583e71b368e7402c1" alt="Katalogi, jossa SendGrid-kortti ja sen painikkeet Käytä automaatioissa, Lue lisää ja Yhdistä" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-sendgrid/01-catalog-card-dark.png" />
</Frame>

<Frame caption="SendGridin yhdistäminen: nimi, API-avain, Lähettäjän sähköposti ja Lähettäjän nimi">
  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-sendgrid/02-connect-modal-light.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=4750194c0f7afef439df206b7a3ae021" alt="SendGridin yhteysikkuna, jossa yhteyden nimi, API-avain, Lähettäjän sähköposti, Lähettäjän nimi ja tapahtumien valintaruudut" className="block dark:hidden" width="2880" height="2800" data-path="images/fi/how-to/connect-sendgrid/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-sendgrid/02-connect-modal-dark.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=8f5acaffaa838d87ad2340d8b27aaf1b" alt="SendGridin yhteysikkuna, jossa yhteyden nimi, API-avain, Lähettäjän sähköposti, Lähettäjän nimi ja tapahtumien valintaruudut" className="hidden dark:block" width="2880" height="2800" data-path="images/fi/how-to/connect-sendgrid/02-connect-modal-dark.png" />
</Frame>

| Kenttä | Pakollinen | Mitä syötetään |
| - | - | - |
| **Yhteyden nimi** | Kyllä | Mikä tahansa nimi, jonka tunnistat, enintään 100 merkkiä. |
| **API-avain** | Kyllä | SendGridin API-avain. Se piilotetaan kirjoitettaessa, tallennetaan salattuna eikä sitä näytetä enää koskaan. |
| **Lähettäjän sähköposti** | Kyllä | Osoite, josta sähköpostit lähtevät. Sen on oltava lähettäjä, jonka olet vahvistanut SendGridissä. |
| **Lähettäjän nimi** | Kyllä | Nimi, jonka asiakkaasi näkevät lähettäjänä, esimerkiksi verkkokauppasi nimi. |

## Tapahtumat, joista SendGrid voi lähettää sähköpostia

| Valintaruutu | Lähetetään, kun |
| - | - |
| **Lähetys luotu** | Lähetys luodaan |
| **Lähetys lähetetty** | Lähetys lähetetään kuljetusyhtiölle ja sillä on osoitekortti |
| **Lähetys peruttu** | Lähetys perutaan tai poistetaan |
| **Seuranta päivitetty** | Kuljetusyhtiö ilmoittaa uuden seurantaskannauksen |

SendGridillä ei ole tilaustapahtumia. Jokainen sähköposti menee lähetyksen asiakkaan sähköpostiosoitteeseen kyseiselle tapahtumalle asetetun mallin mukaan.

<Frame caption="SendGridin lähetys- ja seurantatapahtumat">
  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-sendgrid/07-events-light.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=e9e1eb709aaf39b767077a572fbb4304" alt="SendGridin yhteysikkuna vieritettynä tapahtumien valintaruutuihin, myös Seuranta päivitetty" className="block dark:hidden" width="2880" height="2800" data-path="images/fi/how-to/connect-sendgrid/07-events-light.png" />

  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-sendgrid/07-events-dark.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=c51799e5e62be1ce6d2a1fab93b61976" alt="SendGridin yhteysikkuna vieritettynä tapahtumien valintaruutuihin, myös Seuranta päivitetty" className="hidden dark:block" width="2880" height="2800" data-path="images/fi/how-to/connect-sendgrid/07-events-dark.png" />
</Frame>

## Tarkista yhteys

Valitse yhteysrivin paperilentokone (**Lähetä testitapahtuma**) ja avaa sitten toimituslogi (pistokekuvake). Testitapahtumalla ei ole asiakasta eikä mallia, joten SendGrid hylkää sen, vaikka tietosi olisivat oikein. Varmin tarkistus on oikea tapahtuma tilaukselle, jolla on asiakkaan sähköpostiosoite.

| Toimituslogi näyttää | Mitä tehdä |
| - | - |
| 401 | SendGrid hylkäsi avaimen. Luo uusi avain ja liitä se. |
| 403 | Avaimella ei ole lupaa lähettää sähköpostia tai **Lähettäjän sähköposti** ei ole vahvistettu lähettäjä SendGridissä. |
| 400 | SendGrid ei pystynyt muodostamaan sähköpostia, esimerkiksi koska tapahtumalla ei ole mallia tai asiakkaan sähköpostiosoitetta. Lue SendGridin ilmoittama syy rivin virhetekstistä. |

<Frame caption="SendGrid-yhteys Yhdistetty-välilehdellä">
  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-sendgrid/03-connected-light.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=0fa5288c460c10b376c2600b41b3a0ab" alt="Yhdistetty-välilehti, jossa SendGrid-yhteys sekä testi-, toimituslogi-, muokkaus- ja poistokuvakkeet" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-sendgrid/03-connected-light.png" />

  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-sendgrid/03-connected-dark.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=b18465c46f27715b1f2d1040928693bc" alt="Yhdistetty-välilehti, jossa SendGrid-yhteys sekä testi-, toimituslogi-, muokkaus- ja poistokuvakkeet" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-sendgrid/03-connected-dark.png" />
</Frame>

<Frame caption="Toimituslogi ennen ensimmäistä tapahtumaa">
  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-sendgrid/05-delivery-log-light.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=4fac6722b566c6853a6591e2b11bb8cf" alt="SendGrid-yhteyden toimituslogi-ikkuna, jossa lukee Ei vielä toimituksia" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-sendgrid/05-delivery-log-light.png" />

  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-sendgrid/05-delivery-log-dark.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=9dca3f21381c83cc26725d51f46ee7f9" alt="SendGrid-yhteyden toimituslogi-ikkuna, jossa lukee Ei vielä toimituksia" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-sendgrid/05-delivery-log-dark.png" />
</Frame>

## Muuta tietoja tai katkaise yhteys

Avaa **Muokkaa SendGrid-yhteyttäsi** valitsemalla säätimien kuvake. Jätä **API-avain**, **Lähettäjän sähköposti** ja **Lähettäjän nimi** tyhjiksi, jos haluat säilyttää tallennetut arvot. Jos muutat jotakin niistä, täytä kaikki kolme: mitä tahansa kirjoitat, se korvaa kaiken yhteydelle tallennetun. Valitse **Tallenna muutokset**.

<Frame caption="Muokkaa SendGrid-yhteyttä">
  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-sendgrid/04-edit-modal-light.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=414977eb7faecb1b43d9c942acd66fc1" alt="SendGrid-yhteyden muokkausikkuna, jossa yhteyden nimi, tyhjät API-avain-, Lähettäjän sähköposti- ja Lähettäjän nimi -kentät sekä tapahtumat" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-sendgrid/04-edit-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-sendgrid/04-edit-modal-dark.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=c279a7a34b128e8988e2bf7daa27033a" alt="SendGrid-yhteyden muokkausikkuna, jossa yhteyden nimi, tyhjät API-avain-, Lähettäjän sähköposti- ja Lähettäjän nimi -kentät sekä tapahtumat" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-sendgrid/04-edit-modal-dark.png" />
</Frame>

Katkaise yhteys valitsemalla roskakori, kirjoittamalla DELETE ja valitsemalla **Katkaise yhteys**. Zippendo lopettaa tapahtumien lähettämisen SendGridille ja poistaa toimituslogin.

<Frame caption="Katkaise yhteys kirjoittamalla DELETE">
  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-sendgrid/06-disconnect-modal-light.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=1fd8f555720455ddd354eddf04c8853e" alt="Katkaise integraation yhteys -ikkuna, joka pyytää kirjoittamaan DELETE" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-sendgrid/06-disconnect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-sendgrid/06-disconnect-modal-dark.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=35e5ddc3a379acf02beb1f5da0dd2afb" alt="Katkaise integraation yhteys -ikkuna, joka pyytää kirjoittamaan DELETE" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-sendgrid/06-disconnect-modal-dark.png" />
</Frame>

## Käytä SendGridiä automaatiossa

Lisää kohdassa **Automaatiot** vaihe **Lähetä SendGrid-sähköposti**. Se lähettää sähköpostin automaation käynnistäneelle tapahtumalle, mutta vain kun ehtosi täsmäävät, esimerkiksi vain ulkomaille menevistä lähetyksistä. Se käyttää samaa mallia kuin yhteys kyseiselle tapahtumalle.

| Kenttä | Pakollinen | Mitä se tekee |
| - | - | - |
| **Yhteys** | Kyllä | Valitse SendGrid-yhteytesi luettelosta. Ilman sitä näet viestin **Yhteys on pakollinen**. |
| **Mukautetut ominaisuudet** | Ei | Valitse **Lisää** lähettääksesi mallille lisätietoja, kuten lähetyksen viitteen. |

Katso [Automaatiot](/docs/fi/how-to/automations), kuinka muu automaatio rakennetaan.

## Aiheeseen liittyvää

* [Yhdistä integraatio](/docs/fi/how-to/connect-an-integration) - testaus, toimituslogi, muokkaus ja yhteyden katkaiseminen jokaisessa sovelluksessa
* [SendGrid](/docs/fi/integrations/sendgrid) - pidempi opas
* [Integraatioiden vianmääritys](/docs/fi/integrations/troubleshooting)
* [Automaatiot](/docs/fi/how-to/automations)
* [Yhdistä kuljetusyhtiö tai integraatio](/docs/fi/how-to/connect-index)


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