Vill ni skicka e-post från Pigello med er egen domän som avsändare? Då behöver domänen först verifieras via SendGrid-integrationen.
Med en egen avsändardomän får era utskick ett mer professionellt utseende och stärker samtidigt förtroendet hos mottagarna.
Den här guiden beskriver steg för steg hur ni:
verifierar ägandeskap av en domän
lägger till nödvändiga DNS-inställningar
aktiverar domänen som avsändardomän i Pigello
Så fungerar processen
Konfigurationen av avsändardomänen består av två huvudsteg:
Initiera verifieringen
Pigello hämtar de DNS-records som krävs för att verifiera att ni äger domänen.
Lägg till DNS-records
Ni lägger in recordsen hos er DNS-leverantör och låter därefter Pigello kontrollera verifieringen.
När verifieringen är klar kommer nästa e-postutskick från Pigello automatiskt att använda er egen domän som avsändare.
Översikt av flödet
Processen för att konfigurera avsändardomänen ser ut så här:
Skicka in önskad domän till
set_custom_domainTa emot DNS-records i svaret
Lägg till DNS-recordsen hos DNS-leverantören
Kör
refresh_domain_statusOm status inte är OK:
kontrollera DNS-recordsen
vänta på DNS-propagation
kör kontrollen igen
När verifieringen är klar används domänen som avsändardomän
Förutsättningar
Innan ni börjar konfigurera avsändardomänen behöver ni ha:
en organisation i Pigello med aktiv SendGrid-integration
organisationens ID (organization_id). Har ni flera organisationer i Pigello ska ni använda ID:t för den organisation där SendGrid-integrationen är aktiverad. Kontakta Pigello om ni inte vet vilket ID som gäller.
tillgång till DNS-inställningarna för domänen
en domän ni vill använda, exempelvis:
{
"domain": "test.exempel.se"
}
Två förutsättningar till gäller. Den som ska göra anropen behöver behörighet att hantera integrationer i Pigello, inklusive rätten att ändra en integrations aktiveringsparametrar — utan läsrätt på integrationer slår ingen av de andra rättigheterna igenom. Och vilka integrationer er organisation alls ser avgörs per kund, så en aktiv SendGrid-integration är inte något ni kan ordna själva om integrationen inte är påslagen för er. Kontakta Pigello i så fall.
Steg 1 – Initiera verifiering av domänen
Första steget är att be Pigello skapa verifieringsunderlag för domänen.
Det görs genom att skicka en PUT-request till integrationsendpointen. Anropet kräver autentisering på samma sätt som alla andra API-anrop mot Pigello, så använd samma autentisering som ni redan använder mot Pigellos API.
Endpoint
PUT https://integrationmonitor.api.pigello.io/proxy/
5f5ade80-1327-4808-a5b5-61592b2087dc/
a7510ff4-3ba5-5612-a523-4ef2423c8c85/
2332d708-b30a-504d-8003-65c6b4b5a993/
?method_identifier=set_custom_domain
&target_content_type=sales.organization
&target_object_id={organization_id}
Byt ut {organization_id} mot ID:t för er organisation.
De tre UUID:n som står i adressen identifierar applikationen, tjänsten och tjänstens version. Adressen är alltså låst till en viss version av integrationen. Byts versionen ut slutar adressen fungera och ni behöver nya UUID:n — kontakta Pigello för dem.
Body
Du skickar avsändardomänen i JSON-format:
{
"domain": "test.exempel.se"
}Resultat från steg 1
Pigello returnerar nu de DNS-records som måste läggas till hos er DNS-leverantör.
Det kan exempelvis vara:
CNAME-records
TXT-records
andra verifieringsrecords från SendGrid
Steg 2 – Lägg till DNS-records
Nu behöver ni lägga in DNS-recordsen där er domän hanteras.
Det kan vara hos:
ert webbhotell
DNS-leverantör
domänregistrator
annan DNS-tjänst
Viktigt att kontrollera
Du lägger in recordsen exakt enligt svaret från Pigello och kontrollerar:
host/name
record-typ
värde
TTL
att recordesen läggs i rätt domän/subdomän
Även små fel kan göra att verifieringen misslyckas.
Steg 3 – Kontrollera verifieringsstatus
När DNS-recordsen är tillagda behöver Pigello kontrollera om verifieringen lyckats.
Det görs genom att anropa endpointen för statusuppdatering. Pigello gör det indirekt en kontroll via SendGrid.
Endpoint
PUT https://integrationmonitor.api.pigello.io/proxy/
5f5ade80-1327-4808-a5b5-61592b2087dc/
a7510ff4-3ba5-5612-a523-4ef2423c8c85/
2332d708-b30a-504d-8003-65c6b4b5a993/
?method_identifier=refresh_domain_status
&target_content_type=sales.organization
&target_object_id={organization_id}
Byt ut {organization_id} mot ID:t för den organisation där SendGrid-integrationen är aktiverad.
Body
Ingen body ska skickas med.
Resultat
Responsen visar om avsändardomänen är:
verifierad eller inte verifierad
Om verifieringen misslyckas returneras ofta information om vad som är fel.
Vanliga orsaker till att verifiering misslyckas i steg 3
Felaktiga DNS-records
Vid felaktiga DNS-records kontrollerar du att:
rätt recordtyp används
host/name är korrekt
värdet är exakt rätt
inga extra mellanslag finns
recordsen ligger på rätt domän
DNS-propagation pågår
Även korrekt konfigurerade records kan ta tid att slå igenom globalt.
Gör då så här:
Vänta några minuter
Kör statuskontrollen igen
Upprepa tills status blir OK
När verifieringen är klar
När statuskontrollen visar att domänen är verifierad kommer nästa e-post från Pigello att skickas med den nya avsändardomänen.
Exempel:
Istället för:
mail.pigello.io
kan utskicken skickas från:
mail.ertföretag.se
Stäng av egen domän
Om ni vill återgå till Pigellos standarddomän skickar ni in en tom domän via samma endpoint.
Body
{
"domain": ""
}Efter detta används Pigellos standarddomän igen.
Byta till en annan domän
Vill ni använda en ny domän upprepar ni verifieringsprocessen:
Kör
set_custom_domainLägg till nya DNS-records
Kör
refresh_domain_status
Bra att veta
Tidigare verifierade avsändardomäner i Pigello och SendGrid sparas.
Det betyder att ni senare kan byta tillbaka till en tidigare använd domän utan att verifiera om den – så länge DNS-recordsen fortfarande finns kvar.
Sammanfattning
För att konfigurera en egen avsändardomän behöver ni:
initiera domänverifiering
lägga till DNS-records
kontrollera verifieringsstatus
invänta godkänd verifiering
När allt är klart skickas e-post från Pigello med er egen domän som avsändare – vilket ger både bättre leveransbarhet och ett mer professionellt intryck.