Como enviar contato (vCard) no WhatsApp pelo Notifish

Neste guia você vai ver como enviar contato no WhatsApp pelos dois caminhos, o que é obrigatório em cada um e quando esse recurso faz diferença.

Pré-requisitos

• Uma instância de WhatsApp conectada.
• Atenção ao provedor: o envio de contato está disponível nas instâncias do provedor mais novo (WAHA). Se a sua instância for do provedor anterior, confirme a disponibilidade com o suporte antes de montar a campanha.

Enviando pelo painel (campanha)

O contato é enviado como uma mensagem de campanha:

1. Crie ou abra uma campanha (para contatos ou para grupos) e vá em adicionar mensagem.
2. Em Tipo de conteúdo, marque a opção Contato.
3. Preencha, para cada contato:
   • Nome completo (obrigatório)
   • Telefone com DDI (obrigatório)
   • Empresa (opcional)
   Use Adicionar contato para incluir mais de um cartão na mesma mensagem.
4. Defina a data de envio e salve.

Os contatos são disparados junto com a campanha, na data agendada, para todos os selecionados.

Edição: enquanto a mensagem de contato ainda não foi enviada, você pode editá-la. Depois de enviada, ela não pode mais ser editada — apenas excluída.

Enviando pela API

Há endpoints dedicados, com autenticação via Bearer Token:

POST /api/v2/{instance_uuid}/whatsapp/send-contact          # para contato
POST /api/v2/{instance_uuid}/whatsapp/send-contact/groups   # para grupo

No corpo da requisição, cada contato pode ser informado de dois modos:

{
  "recipient_phone": "5511999999999",
  "contacts": [
    {
      "fullName": "Maria Silva",
      "phoneNumber": "+55 11 98888-7777",
      "organization": "Empresa X",
      "whatsappId": "5511988887777"
    },
    {
      "vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:João Souza\nTEL;type=CELL:+55 11 97777-6666\nEND:VCARD"
    }
  ]
}

• Modo estruturado: informe fullName e phoneNumber (organization e whatsappId são opcionais).
• Modo vCard: informe o vcard cru completo — útil quando você já tem o cartão pronto e quer preservar todos os campos.
• Limite de 20 contatos por mensagem.

O envio é assíncrono. A documentação completa está em developers.notifish.com.

Por que usar o envio de contato

• Telefone clicável, sem atrito: o cliente recebe o cartão e salva ou conversa com um toque — nada de copiar número de dentro de um texto.
• Indicação e roteamento: encaminhe o contato do vendedor certo, do suporte ou do parceiro direto na conversa, de forma profissional.
• Em escala: o mesmo contato (ou uma lista deles) vai para toda a campanha de uma vez, com agendamento.

Perguntas frequentes

Posso enviar mais de um contato na mesma mensagem?

Sim, até 20 contatos por mensagem.

O contato chega clicável, para salvar?

Sim. Ele chega como um cartão nativo do WhatsApp, com opção de salvar e de iniciar conversa.

Preciso do vCard pronto?

Não. Pelo painel, basta nome e telefone. Pela API, você escolhe: campos estruturados ou o vCard cru.

Funciona em grupo?

Sim, o envio funciona tanto para contatos quanto para grupos.

Consigo editar depois de enviado?

Enquanto não foi enviado, sim. Depois de enviado, resta apenas excluir.