conversas-v2-contacts

Atualizar contato de WhatsApp Business por broker

Atualizar contato de WhatsApp Business por broker.

Regras obrigatórias do payload:

  • full_name, cel_phone e integration são obrigatórios.
  • cel_phone no formato E.164: [CC][NDC][SN]. Exemplo (Brasil): 5511999998888.

⚠️ Observação sobre tags: Envie tags como array de strings (ex.: ["vip", "lead"]). Tags inseridas no contato são substituídas pelas novas tags enviadas na requisição.

put/v2/contacts/whatsapp-business-by-brokers

Request

  • Base URL
    https://api.tallos.com.br
  • URL
    https://api.tallos.com.br/v2/contacts/whatsapp-business-by-brokers
  • Auth
    HTTP bearer

Request body

birth_datestring nullable

Data de nascimento no formato brasileiro (DD/MM/YYYY).

cel_phonestring required

Número no formato E.164: [CC][NDC][SN] (apenas dígitos). Exemplo (Brasil): 5511999998888.

cel_phone_secondary0string nullable

Número de telefone alternativo.

cel_phone_secondary1string nullable

Número de telefone alternativo.

cnpjstring nullable

Número de CNPJ do contato.

codestring nullable

Código do contato.

cpfstring nullable

Número de CPF do contato.

descriptionstring nullable

Descrição.

emailstring email nullable

Endereço de e-mail do contato.

full_namestring required

Nome completo do contato.

integrationstring required

Integração do WhatsApp a qual o contato será atualizado.

rgstring nullable

Número de RG do contato.

tagsstring[] nullable

Tags do contato. Array de nomes (ex.: ["vip", "lead"]). O envio substitui as tags existentes.

whatsapp_namestring

Nome da integração do WhatsApp Business (opcional).

Example request

{
  "address": {
    "city": "Fortaleza",
    "complement": "5º andar",
    "country": "Brazil",
    "district": "Centro",
    "number": "1234",
    "state": "Ceará",
    "street": "Av. Principal",
    "zip_code": "12345-600"
  },
  "birth_date": "30/03/1992",
  "cel_phone": "5511999998888",
  "cnpj": "12.345.678/0009-10",
  "cpf": "123.456.789-10",
  "full_name": "John Tallos",
  "integration": "integration-1",
  "job": {
    "cnpj": "12.345.678/0009-10",
    "company": "RD Station",
    "department": "Controladoria",
    "phone": "+55 11 999-888-777",
    "site": "https://tallos.com.br",
    "title": "Gerente"
  },
  "rg": "12.345.678-9"
}

Response

Contato atualizado com sucesso

messagestring required

Mensagem de callback.

Example response

{
  "data": {
    "_id": "507f191e810c19729de860ea",
    "address": {
      "city": "Fortaleza",
      "complement": "5º andar",
      "country": "Brazil",
      "district": "Centro",
      "number": "1234",
      "state": "Ceará",
      "street": "Av. Principal",
      "zip_code": "12345-600"
    },
    "birth_date": "30/03/1992",
    "cel_phone": "+55 11 999-888-777",
    "cnpj": "12.345.678/0009-10",
    "cpf": "123.456.789-10",
    "customizable_field": [
      {
        "info": "123456",
        "label": "CRM"
      }
    ],
    "email": "john.tallos@email.com",
    "employee": "507f191e810c19729de860ea",
    "full_name": "Tallos Example",
    "integration": "integration-1",
    "job": {
      "cnpj": "12.345.678/0009-10",
      "company": "RD Station",
      "department": "Controladoria",
      "phone": "+55 11 999-888-777",
      "site": "https://tallos.com.br",
      "title": "Gerente"
    },
    "rg": "12.345.678-9"
  },
  "message": "Success created contact"
}

Changes

No recorded changes to this operation across all 1 revision of this API.