> ## Documentation Index > Fetch the complete documentation index at: https://help.wizebot.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Excluir contato > Remove o contato e tudo que depende dele, inclusive as mídias trocadas. **Não é reversível.** ## OpenAPI ````yaml /openapi.json delete /whatsapp/contacts openapi: 3.1.0 info: title: API WizeBot version: 3.0.0 description: >- A API da WizeBot tem duas camadas sobre a **mesma base** `https://api.wizebot.com.br/v1`. **Contrato multicanal** — a camada neutra. Os mesmos endpoints falam com WhatsApp, com Telegram e com os canais que vierem depois. O canal não aparece na URL nem no corpo: ele vem da conta escolhida como remetente. Campos, códigos e mensagens em inglês. **API de WhatsApp** — a camada específica do canal, com o que só o WhatsApp tem. Continua existindo e não muda; quem já integrou com ela não precisa migrar. Toda requisição se autentica por cabeçalho. Não há autenticação por corpo nem por query string. servers: - url: https://api.wizebot.com.br/v1 description: Produção security: - bearerAuth: [] tags: - name: Canais description: Contas de canal conectadas e o que cada uma aceita. - name: Mensagens description: Envio e status pelo contrato neutro, em qualquer canal. - name: WhatsApp · Mensagens description: Envio, status e modelos na camada específica de WhatsApp. - name: WhatsApp · Contatos description: Contatos e campos personalizados. - name: WhatsApp · Etiquetas description: Etiquetas e sua atribuição a contatos. - name: WhatsApp · Sequências description: Sequências agendadas de um contato. - name: WhatsApp · Conta description: Verificação da chave de API. paths: /whatsapp/contacts: delete: tags: - WhatsApp · Contatos summary: Excluir contato description: |- Remove o contato e tudo que depende dele, inclusive as mídias trocadas. **Não é reversível.** operationId: whatsappExcluirContato requestBody: required: true content: application/json: schema: type: object properties: phone_number_id: type: string phone_number: type: string required: - phone_number_id - phone_number example: phone_number_id: '102938475610293' phone_number: '5511999999999' responses: '200': description: Contato excluído. content: application/json: schema: type: object required: - success - data - timestamp properties: success: type: boolean description: Sempre `true` nas respostas de sucesso. data: type: object properties: message: type: string timestamp: type: string format: date-time example: success: true data: message: Contact deleted successfully. timestamp: '2026-09-09T17:15:20.453Z' '400': description: '`MISSING_PARAM` — phone_number is required.' content: application/json: schema: $ref: '#/components/schemas/ErroDaApi' examples: MISSING_PARAM: summary: MISSING_PARAM value: success: false statusCode: 400 timestamp: '2026-09-09T17:15:20.453Z' path: /api/v1/whatsapp/contacts method: DELETE message: error: MISSING_PARAM message: phone_number is required. errorId: ERR-MTUD0DBO-KKRMP8 '401': description: '`UNAUTHORIZED` — Invalid or missing API key.' content: application/json: schema: $ref: '#/components/schemas/ErroDaApi' examples: UNAUTHORIZED: summary: UNAUTHORIZED value: success: false statusCode: 401 timestamp: '2026-09-09T17:15:20.453Z' path: /api/v1/whatsapp/contacts method: DELETE message: error: UNAUTHORIZED message: Invalid or missing API key. errorId: ERR-MTUD0DBO-KKRMP8 '404': description: '`CONTACT_NOT_FOUND` — Contact not found.' content: application/json: schema: $ref: '#/components/schemas/ErroDaApi' examples: CONTACT_NOT_FOUND: summary: CONTACT_NOT_FOUND value: success: false statusCode: 404 timestamp: '2026-09-09T17:15:20.453Z' path: /api/v1/whatsapp/contacts method: DELETE message: error: CONTACT_NOT_FOUND message: Contact not found. errorId: ERR-MTUD0DBO-KKRMP8 '429': description: '`RATE_LIMITED` — Too many requests.' content: application/json: schema: $ref: '#/components/schemas/ErroDaApi' examples: RATE_LIMITED: summary: RATE_LIMITED value: success: false statusCode: 429 timestamp: '2026-09-09T17:15:20.453Z' path: /api/v1/whatsapp/contacts method: DELETE message: error: RATE_LIMITED message: Too many requests. errorId: ERR-MTUD0DBO-KKRMP8 components: schemas: ErroDaApi: type: object description: >- Corpo de erro da API. `message` é um **objeto** com o código nomeado — não uma string. required: - success - statusCode - message properties: success: type: boolean description: Sempre `false`. statusCode: type: integer timestamp: type: string format: date-time path: type: string description: >- Caminho interno da requisição. Traz o prefixo `/api/v1` mesmo quando você chamou por `/v1`: o apelido é reescrito antes do roteamento. method: type: string message: type: object required: - error - message properties: error: type: string description: >- Código nomeado. É por ele que se trata o erro em código, nunca pelo texto. message: type: string description: Descrição em inglês, para leitura humana. details: type: object additionalProperties: true description: >- Contexto estruturado, presente nos códigos que o emitem — `CHANNEL_MISMATCH`, `NO_OPEN_CONVERSATION`, `RECIPIENT_NOT_ON_CHANNEL` e `UNSUPPORTED_CAPABILITY`. errorId: type: string description: Identificador do erro. Cite-o ao falar com o suporte. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Chave de API no cabeçalho `Authorization: Bearer SUA-CHAVE`. A API também aceita `x-api-key: SUA-CHAVE` e `Authorization: ApiKey SUA-CHAVE` — as três formas são equivalentes, inclusive para o limite de requisições. A chave dá acesso total à conta e é de servidor para servidor: não a use em navegador ou aplicativo móvel. ````