ArgorantDocs

Encontre 200 pessoas e envie e-mails para elas

De para quem você vende até uma campanha em andamento: chegue a cerca de 200 pessoas, escreva os e-mails com uma linha personalizada, escolha as caixas de e-mail e inicie depois de um sim.

Este guia leva cerca de 15 minutos. A busca é grátis. Adicionar as pessoas custa 1 crédito por pessoa cujo e-mail passa na verificação, ou seja, cerca de 200 créditos. Os e-mails em si já vêm com o seu plano.

Você precisa de uma chave de API, de um plano ou de créditos suficientes, e de pelo menos uma caixa de e-mail conectada. Confira as caixas de e-mail com GET /api/v1/inboxes. Ainda não tem caixa de e-mail? Conecte um Google Workspace em uma etapa, conecte o Microsoft 365 no app, conecte uma caixa de e-mail de qualquer outro provedor ou peça novas caixas de e-mail com POST /api/v1/inboxes/quote.

Diga para quem você vende

Escolha os cargos, o setor, o país e o tamanho da empresa. Use as listas de termos gratuitas para obter os nomes exatos:

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

Reduza a contagem para cerca de 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}

Muitas? Adicione uma cidade, um nível hierárquico ou um porte de empresa menor. Poucas? Adicione mais cargos ou países. Contar é grátis, então tente quantas vezes quiser.

Veja uma página delas

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"

Se os cargos e as empresas parecerem certos, siga em frente. Se não, mude os filtros e conte de novo.

Salve como lista

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"}}'

Anote o list_id. A lista se preenche sozinha em poucos segundos.

Crie a campanha

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"}'

Ela é um rascunho. Novas campanhas enviam texto simples em dias úteis e não têm linha de descadastro, a menos que você defina include_unsubscribe como true.

Escreva os 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}} é o nome da empresa como as pessoas o falam. {{custom_opener}} é uma linha personalizada por pessoa, que você configura a seguir. Texto que sobrou, como [link], volta em warnings, e a campanha não inicia até ele sair.

Adicione uma linha personalizada (opcional)

Configure a linha uma vez, com um texto alternativo que soe bem para qualquer pessoa:

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."}]}'

Depois, GET .../personalization lista as pessoas que ainda estão com o texto alternativo, com fatos sobre a empresa delas, e PATCH .../leads/custom-fields salva as linhas que você ou o seu agente escreveram, até 5.000 por chamada. Uma linha que alguém já tem fica, a menos que você envie "overwrite": true, então uma segunda execução nunca substitui linhas por engano. Uma instrução pode ter até 4.000 caracteres e cada linha de 20 a 300 (max_length, 150 por padrão); veja Escrever linhas personalizadas para todos os limites.

Adicione as pessoas

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}'

A primeira resposta pode ser uma pergunta (needs_choice: true): quantos endereços estão confirmados e quantos estão em domínios que aceitam qualquer endereço. Pergunte ao usuário e chame de novo com "grades": ["valid"] (recomendado) ou ["valid", "catch_all"]. Cada nova pessoa custa 1 crédito. Pessoas cujo e-mail não passa na verificação nunca são adicionadas nem cobradas.

Escolha as caixas de e-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}'

Inicie depois de um sim

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

Mostre ao usuário os e-mails, o número de pessoas e as caixas de e-mail. launch_blockers precisa estar vazio. Depois, só após o sim dele:

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"

As respostas chegam à caixa de entrada. Responda às respostas mostra como lê-las, responder na mesma conversa e acompanhar o seu funil. GET /api/v1/campaigns/$ID/analytics traz os números por dia.

Nesta página