ArgorantDocs

Trouver 200 personnes et leur écrire

De votre cible à une campagne en cours : réduisez à environ 200 personnes, rédigez les e-mails avec une phrase personnalisée, choisissez les boîtes mail et lancez après un oui.

Ce guide prend environ 15 minutes. La recherche est gratuite. Ajouter les personnes coûte 1 crédit par personne dont l'e-mail passe la vérification, donc environ 200 crédits. Les e-mails eux-mêmes sont compris dans votre forfait.

Il vous faut une clé API, un forfait ou assez de crédits, et au moins une boîte mail connectée. Vérifiez les boîtes mail avec GET /api/v1/inboxes. Pas encore de boîte mail ? Connectez un Google Workspace en une étape, connectez Microsoft 365 dans l'app, connectez une boîte mail de n'importe quel autre fournisseur ou commandez de nouvelles boîtes mail avec POST /api/v1/inboxes/quote.

Dites à qui vous vendez

Choisissez les intitulés de poste, le secteur, le pays et la taille d'entreprise. Utilisez les listes de mots gratuites pour obtenir les noms exacts :

Shell
curl -G "https://app.argorant.com/api/v1/lookups/industries" -H "Authorization: Bearer $ARGORANT_API_KEY" --data-urlencode "q=logistics"

Réduisez le comptage à environ 200

Shell
curl -G "https://app.argorant.com/api/v1/people/count" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  --data-urlencode "title=Head of Operations,COO" --data-urlencode "industries=Truck Transportation" \
  --data-urlencode "country=Netherlands" --data-urlencode "employee_range=51-200"
# {"count": 214}

Trop de monde ? Ajoutez une ville, un niveau hiérarchique ou une taille d'entreprise plus petite. Trop peu ? Ajoutez des intitulés ou des pays. Le comptage est gratuit, alors essayez autant que vous voulez.

Regardez une page de résultats

Shell
curl -G "https://app.argorant.com/api/v1/people/search" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  --data-urlencode "title=Head of Operations,COO" --data-urlencode "industries=Truck Transportation" \
  --data-urlencode "country=Netherlands" --data-urlencode "employee_range=51-200"

Si les postes et les entreprises vous conviennent, continuez. Sinon, changez les filtres et comptez de nouveau.

Enregistrez-les comme liste

Shell
curl -X POST "https://app.argorant.com/api/v1/lists" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: ops-nl-list" -H "Content-Type: application/json" \
  -d '{"name":"Ops leaders NL trucking","filters":{"title":"Head of Operations,COO","industries":"Truck Transportation","country":"Netherlands","employee_range":"51-200"}}'

Notez le list_id. La liste se remplit toute seule en quelques secondes.

Créez la campagne

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: ops-nl-campaign" -H "Content-Type: application/json" \
  -d '{"name":"NL trucking ops Q4","daily_limit":40,"timezone":"Europe/Amsterdam","window_start":"08:30","window_end":"16:30"}'

C'est un brouillon. Les nouvelles campagnes envoient du texte brut en semaine et n'ont pas de ligne de désinscription, sauf si vous mettez include_unsubscribe à true.

Rédigez les e-mails

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/emails" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: ops-nl-emails-1" -H "Content-Type: application/json" \
  -d '{"emails":[
    {"subject":"Planning at {{company_normalized}}","body":"Hi {{first_name}},\n\n{{custom_opener}}\n\nWe help trucking firms cut empty miles. Worth a short call next week?\n\nBest, Maria"},
    {"body":"Hi {{first_name}}, just bringing this back up. Happy to send a two-minute video instead.","delay_days":3}
  ]}'

{{company_normalized}} est le nom de l'entreprise tel qu'on le dit au quotidien. {{custom_opener}} est une phrase personnalisée par personne, que vous configurez à l'étape suivante. Un texte oublié comme [link] revient dans warnings, et la campagne ne se lance pas tant qu'il reste là.

Ajoutez une phrase personnalisée (facultatif)

Configurez la phrase une fois, avec un texte de repli qui convient à tout le monde :

Shell
curl -X PUT "https://app.argorant.com/api/v1/campaigns/$ID/personalization" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"variables":[{"name":"opener","instruction":"One sentence about something recent at their company.","fallback":"Hope the busy season treats you well."}]}'

Ensuite, GET .../personalization liste les personnes qui ont encore le texte de repli, avec des informations sur leur entreprise, et PATCH .../leads/custom-fields enregistre les phrases que vous ou votre agent avez écrites, jusqu'à 5 000 par appel. Une phrase déjà présente est conservée, sauf si vous envoyez "overwrite": true, si bien qu'un second passage ne remplace jamais de phrases par erreur. Une instruction peut compter jusqu'à 4 000 caractères et chaque phrase de 20 à 300 (max_length, 150 par défaut) ; voir Écrire des phrases personnalisées pour toutes les limites.

Ajoutez les personnes

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/leads" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: ops-nl-leads" -H "Content-Type: application/json" \
  -d '{"list_id": 312}'

La première réponse peut être une question (needs_choice: true) : combien d'adresses sont confirmées et combien se trouvent sur des domaines qui acceptent toutes les adresses. Demandez à l'utilisateur, puis rappelez avec "grades": ["valid"] (recommandé) ou ["valid", "catch_all"]. Chaque nouvelle personne coûte 1 crédit. Les personnes dont l'e-mail ne passe pas la vérification ne sont jamais ajoutées ni facturées.

Choisissez les boîtes mail

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/senders" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Content-Type: application/json" -d '{"all_connected": true}'

Lancez après un oui

Shell
curl "https://app.argorant.com/api/v1/campaigns/$ID" -H "Authorization: Bearer $ARGORANT_API_KEY"

Montrez à l'utilisateur les e-mails, le nombre de personnes et les boîtes mail. launch_blockers doit être vide. Ensuite, seulement après son oui :

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/launch" -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: ops-nl-launch"

Les réponses arrivent dans la boîte de réception. Répondre aux réponses montre comment les lire, répondre dans le même fil et suivre votre pipeline. GET /api/v1/campaigns/$ID/analytics donne les chiffres par jour.

Sur cette page