Denne handling er mulig at udføre for en API bruger med admin eller brugerdefineret ruter rettigheder. |
Denne artikel forklarer, hvordan du indsætter emner i en kampagne ved at bruge POST /leads endpoint.
Vi har også en video her, der forklarer, hvordan man gør det.
Hvis du i stedet ønsker at vide, hvordan du bulk-importerer, så gå til denne artikel. Du kan også finde vores API dokumentation lige her.
Når en succesfuld request er sendt til et endpoint, sker der følgende to ting:
En kontakt oprettes i en emnepulje.
Kontakten tilføjes til en kampagne, som resulterer i oprettelsen af et emne.
For at få en bedre forståelse af forskellen er på kontakter og emner, tag et kig på denne artikel.
De eneste nødvendige parametre for en simpel POST request er campaignId, pool, og masterData - en samling af felt-ID'er og -værdier.
curl --location --request POST 'https://api.adversus.io/v1/leads' \--header 'Authorization: Basic XX' \--header 'Content-Type: application/json' \--data-raw '{ "campaignId": 27305, "pool": 26024, "masterData":[ { "id": 1, // field id "value": "adversus.io" // value }, { "id": 2, "value": "+1 (337) 385 5102" } ]}'
Tjek venligst den officielle API dokumentation for detaljer om, hvordan du får campaign, pool, og field ID'er.
Du kan tilføje følgende parametre til din request, hvis det er nødvendigt:
Parameter | Formål |
nextContactTime | Emnet er som standard ringbart efter indsættelse. Hvis du vil planlægge et opkald i fremtiden, skal du tilføje dette parameter for dato/tid. |
lastContactedBy | Hvis du indsætter emnet som personligt genopkald, kan dette felt udfyldes med bruger-ID på agenten, som skal modtage genopkaldet. |
status | Statusfeltet er som standard sat som Ubehandlet. Brug dette parameter, hvis du ønsker at indsætte emnet med en anden status. |
externalId | Eksterne ID'er kan være nyttige ved integration med eksterne systemer. Se denne artikel for flere detaljer. |