Responsáveis Financeiros (Financial Managers)

O Responsável Financeiro representa a pessoa física ou jurídica responsável pela conta e pela carteira de créditos do WhatsApp Oficial. É contra ele que as cobranças da MessageFy são emitidas (não da Meta): os créditos pagos alimentam a carteira usada nos envios.

Um canal whatsapp-api não pode ser criado sem que a Account tenha um responsável financeiro com isDefault: true — a criação falha com METAGURU_FINANCIAL_MANAGER_REQUIRED.

Todos os endpoints usam o header X-API-KEY e o escopo da chave (org_/acc_) se aplica normalmente.

Listar

GET /api/v1/Admin/FinancialManager

Query	Tipo	Obrigatório	Descrição
`accountId`	uuid	Não	Filtra pelos responsáveis de uma conta
`page`	int	Não	Página (padrão 1)
`perPage`	int	Não	Itens por página (padrão 10, máx 50)

Resposta 200: lista de objetos com financialManagerId, name, parameters (dados abaixo), isDefault, isEnabled, createdAt, updatedAt, accountId, accountName, organizationId, organizationName.

Criar

POST /api/v1/Admin/FinancialManager

{
  "accountId": "019f1a8a-7e30-79dd-be6e-a379e4fa4904",
  "name": "Financeiro Principal",
  "isDefault": true,
  "parameters": {
    "name": "Paiva Neto Enterprises",
    "title": "Arquitetura",
    "legalName": "Paiva Neto LTDA",
    "document": "CNPJ",
    "documentNumber": "63629891000160",
    "slug": "paivaneto",
    "email": "financeiro@paivaneto.com.br",
    "phone": "5559978498830",
    "contactName": "Gabriel Xavier",
    "contactPhone": "5579223393757",
    "contactEmail": "gabriel@paivaneto.com.br"
  }
}

uuid

Conta dona do responsável. Preenchido automaticamente quando a chave é de Account (acc_).

string

required

Título de referência do registro (como ele aparece nas listagens).

boolean

required

Define o responsável padrão da conta — é o padrão que os canais oficiais usam.

string

required

Razão social / nome legal. Deve corresponder ao documento informado.

string

required

Tipo do documento: "CPF" ou "CNPJ".

string

required

Número do documento, somente dígitos.

string

required

Nome curto para identificação via URL — sempre em minúsculas e sem espaços.

string

required

E-mail oficial da empresa/pessoa (usado nas cobranças).

string

required

Telefone oficial.

string

Nome de exibição da pessoa ou empresa.

string

Cargo ou setor.

string

Pessoa de contato responsável.

string

Telefone da pessoa de contato.

string

E-mail da pessoa de contato.

Resposta 200: o objeto completo criado (mesmos campos da listagem).

Obter por id

GET /api/v1/Admin/FinancialManager/{id}

Atualizar

PUT /api/v1/Admin/FinancialManager/{id}

Mesmo corpo do Criar (substituição completa do registro).

Remover

DELETE /api/v1/Admin/FinancialManager/{id}

Resposta: 204 No Content.

Erros

Status	Descrição
`400`	Validação (lista de erros com `errorCode`)
`401`	Chave inválida ou recurso fora do escopo da chave
`404`	Responsável não encontrado

Início

Contas

API Keys

Canais

WhatsApp Oficial

Tipos de Mensagem

Operações de Mensagem

Sessão e Conexão

Consultas

Interação

Responsáveis Financeiros

Responsáveis Financeiros (Financial Managers)

Listar

Criar

Obter por id

Atualizar

Remover

Erros

​Responsáveis Financeiros (Financial Managers)

​Listar

​Criar

​Obter por id

​Atualizar

​Remover

​Erros

Responsáveis Financeiros (Financial Managers)

Listar

Criar

Obter por id

Atualizar

Remover

Erros