Wiza

Wiza é uma plataforma de dados de contatos B2B que encontra e verifica e-mails e números de telefone para equipes de vendas, recrutamento e marketing. O Wiza combina uma base global de prospects com enriquecimento em tempo real, para que os dados com que você age permaneçam precisos e entregáveis.

Com o Wiza, você pode:

  • Pesquisar uma base global de prospects: Encontrar pessoas usando filtros de pessoa, empresa e financeiros
  • Enriquecer empresas: Resolver dados firmográficos a partir de um nome, domínio ou URL do LinkedIn
  • Revelar contatos individuais: Obter e-mails de trabalho verificados, e-mails pessoais e números de celular
  • Acompanhar uso de créditos: Verificar créditos restantes de e-mail, telefone, export e API a qualquer momento

No Zoen, a integração do Wiza permite que seus agentes conduzam fluxos de trabalho de prospecção e enriquecimento de ponta a ponta:

  • Prospect Search: Use wiza_prospect_search para descobrir prospects que correspondam a filtros detalhados.
  • Company Enrichment: Use wiza_company_enrichment para enriquecer uma empresa a partir de nome, domínio, LinkedIn ID ou LinkedIn slug.
  • Start Individual Reveal: Use wiza_start_individual_reveal para iniciar o enriquecimento de um contato via URL do LinkedIn, nome + empresa ou e-mail — com profundidade de enriquecimento configurável (none, partial, phone, full).
  • Get Individual Reveal: Use wiza_get_individual_reveal para consultar um reveal e recuperar e-mails verificados, telefones e contexto completo da empresa.
  • Get Credits: Use wiza_get_credits para monitorar saldos de créditos restantes antes de escalar execuções.

Reveals individuais são assíncronos: inicie um reveal e depois consulte wiza_get_individual_reveal até que is_complete seja true. Combine essas ferramentas para construir agentes que originam, enriquecem e qualificam leads sob demanda — sem sair do seu fluxo de trabalho.

Usage Instructions

Wiza API Key Setup

Wiza authenticates via API key. To get yours:

  1. Log in to your Wiza account.
  2. Open Settings → API and generate a new API key (or copy an existing one).
  3. In Zoen, open the Wiza block and paste the key into the Wiza API Key field.

The same key is used for every Wiza operation. Wiza enforces a rate limit of 30 requests per minute (43,200 per day) per key.

Individual Reveals Are Asynchronous

wiza_start_individual_reveal returns immediately with a reveal id and a status of queued or resolving. To retrieve the enriched contact data, call wiza_get_individual_reveal with that id and check is_complete. Possible statuses are queued, resolving, finished, and failed.

For real-time delivery without polling, pass a callback_url when starting the reveal — Wiza will POST the completed payload to that URL.

Enrichment Levels and Credits

When starting an individual reveal, choose the enrichment level that matches the data you need:

  • none — Identity only, no contact info (no credit spend)
  • partial — Verified work email (email credits)
  • phone — Mobile phone (phone credits)
  • full — Email + phone (email + phone credits)

Use wiza_get_credits to monitor remaining email, phone, export, and API credits before running large batches.

Integrates Wiza into the workflow. Search prospects, enrich companies, reveal verified emails and phone numbers for individuals, and check your account credit balance.

Actions

Search Wiza's database of prospects using person, company, and financial filters

Input

ParameterTypeRequiredDescription
apiKeystringYesWiza API key
sizenumberNoNumber of sample profiles to return (0-30, default 0)
filtersobjectNoFull filters object (overrides individual filter params if provided)
first_namearrayNoExact first names to match (e.g., ["John", "Jane"])
last_namearrayNoExact last names to match
job_titlearrayNoJob titles to include/exclude (e.g., [{"v":"CEO","s":"i"},{"v":"CTO","s":"e"}])
job_title_levelarrayNoSeniority levels (e.g., ["cxo", "director", "manager"])
job_rolearrayNoJob role categories (e.g., ["sales", "engineering", "marketing"])
job_sub_rolearrayNoDetailed role categories (e.g., ["software", "product"])
locationarrayNoPerson's location filters (city/state/country with include/exclude)
skillarrayNoProfessional skills (e.g., ["python", "marketing"])
schoolarrayNoEducational institutions
majorarrayNoField of study
linkedin_slugarrayNoLinkedIn profile slugs
job_companyarrayNoCurrent company filters (include/exclude)
past_companyarrayNoPast company filters
company_locationarrayNoCompany HQ location filters
company_industryarrayNoCompany industry filters (include/exclude)
company_sizearrayNoCompany headcount brackets (e.g., ["1-10", "11-50", "51-200"])
company_typearrayNoCompany type (e.g., ["private", "public", "educational"])

Output

ParameterTypeDescription
totalnumberTotal number of matching prospects
profilesarraySample profiles matching the filter criteria

wiza_company_enrichment

Enrich a company by name, domain, LinkedIn ID, or LinkedIn slug with detailed firmographic data

Input

ParameterTypeRequiredDescription
apiKeystringYesWiza API key
company_namestringNoCompany name (e.g., "Wiza")
company_domainstringNoCompany domain (e.g., "wiza.co")
company_linkedin_idstringNoCompany LinkedIn ID
company_linkedin_slugstringNoCompany LinkedIn slug from the URL

Output

ParameterTypeDescription
company_namestringCompany name
company_domainstringCompany domain
domainstringDomain
company_industrystringIndustry
company_sizenumberEmployee count
company_size_rangestringHeadcount range
company_foundednumberYear founded
company_revenue_rangestringRevenue range
company_fundingstringTotal funding
company_typestringCompany type
company_descriptionstringDescription
company_tickerstringStock ticker
company_last_funding_roundstringLast funding round
company_last_funding_amountstringLast funding amount
company_last_funding_atstringLast funding date
company_locationstringFull location string
company_twitterstringTwitter URL
company_facebookstringFacebook URL
company_linkedinstringLinkedIn URL
company_linkedin_idstringLinkedIn ID
company_streetstringStreet address
company_localitystringCity
company_regionstringState/region
company_postal_codestringPostal code
company_countrystringCountry
creditsjsonCredits deducted for this enrichment (api_credits: { total, company_credits })

wiza_individual_reveal

Reveal a contact via LinkedIn URL, name + company/domain, or email. Starts the reveal and polls until it resolves. Uses 2 credits per valid email and 5 credits per phone, charged only on success.

Input

ParameterTypeRequiredDescription
apiKeystringYesWiza API key
enrichment_levelstringYesEnrichment depth: none, partial, phone, or full
profile_urlstringNoLinkedIn profile URL (e.g., https://linkedin.com/in/johndoe\)
full_namestringNoFull name (used with company or domain)
companystringNoCompany name (used with full_name)
domainstringNoCompany domain (used with full_name)
emailstringNoEmail address (use alone or with other identifiers)
accept_workbooleanNoWhether to accept work emails (email_options)
accept_personalbooleanNoWhether to accept personal emails (email_options)

Output

ParameterTypeDescription
idnumberReveal ID
statusstringqueued | resolving | finished | failed
is_completebooleanWhether the reveal has completed
namestringFull name
companystringCompany name
enrichment_levelstringEnrichment level used
linkedin_profile_urlstringLinkedIn URL
titlestringJob title
locationstringLocation
emailstringPrimary email
email_typestringEmail type
email_statusstringvalid | risky | unfound
emailsarrayAll emails found
mobile_phonestringMobile phone
phone_numberstringDirect/office phone
phone_statusstringfound | unfound
phonesarrayAll phones found
company_sizenumberEmployee count
company_size_rangestringHeadcount range
company_typestringCompany type
company_domainstringCompany domain
company_localitystringCity
company_regionstringState/region
company_countrystringCountry
company_streetstringStreet
company_postal_codestringPostal code
company_foundednumberYear founded
company_fundingstringFunding total
company_revenuestringRevenue
company_industrystringIndustry
company_subindustrystringSubindustry
company_linkedinstringCompany LinkedIn URL
company_locationstringFull company location
company_descriptionstringCompany description
creditsjsonCredits consumed by the reveal

wiza_get_credits

Retrieve the remaining credits on your Wiza account

Input

ParameterTypeRequiredDescription
apiKeystringYesWiza API key

Output

ParameterTypeDescription
email_creditsjsonRemaining email credits (number or "unlimited")
phone_creditsjsonRemaining phone credits (number or "unlimited")
export_creditsnumberRemaining export credits
api_creditsnumberRemaining API credits

On this page