Como escolher entre ws, ws_avatar e ws_business

O WA Lookup oferece três verificações de WhatsApp por trás de uma única chamada. Escolher entre elas é uma questão de quais campos seu fluxo de trabalho vai realmente ler, e não de níveis de recursos.

As três verificações de WhatsApp do WA Lookup usam POST /api/v1/check e diferem apenas no valor de service_type: ws retorna o campo de registro, ws_avatar acrescenta avatar e avatar_url, e ws_business acrescenta um booleano business.

ws quando um único campo decide o resultado

Se a próxima etapa do seu fluxo de trabalho depende apenas de haver ou não uma conta do WhatsApp, ws retorna exatamente isso e nada que você não vá ler. Escolher um service_type mais completo nessa situação aumenta o custo de cada chamada sem mudar nenhuma decisão tomada pelo seu código.

ws_avatar quando a visibilidade do perfil importa

Escolha ws_avatar quando alguma etapa posterior ler os campos de avatar: ordenar uma fila de leads, enriquecer um registro do CRM ou dar mais contexto a um revisor. A pergunta decisiva é se algum código ou alguma pessoa vai olhar o valor do avatar. Se não, ws é a melhor escolha.

ws_business quando o tipo de conta define o roteamento

ws_business acrescenta um booleano business, adequado a fluxos de trabalho que tratam contas Business de forma diferente das demais. Assim como no ws_avatar, o critério é se esse campo chega a influenciar uma decisão — um campo retornado e ignorado é puro custo.

Escolher por chamada, e não por integração

Como service_type é um valor no corpo da mesma chamada, uma única integração pode selecionar verificações diferentes para listas ou etapas diferentes. É comum as equipes executarem primeiro ws em uma lista grande e depois um service_type mais completo no subconjunto que interessa, o que mantém o gasto proporcional ao valor de cada etapa.

Perguntas frequentes

As três verificações usam URLs diferentes?

Não. As três usam POST /api/v1/check e são selecionadas pelo valor de service_type no corpo da requisição.

Uma integração pode combinar tipos de serviço?

Sim. service_type é um valor do corpo de cada requisição, então listas ou etapas diferentes podem selecionar verificações diferentes pela mesma integração.

O ws_avatar inclui o que o ws retorna?

Sim. Ele retorna o campo de registro e acrescenta os campos de avatar.