BatZapDesenvolvedoresEnglishGerar chave de API

    Primeiros passos

    Visão geralInício rápidoAutenticaçãoEscoposLimites de usoErrosServidor MCP

    Conta

    GETVerificar statusGETListar integrações

    Conversas

    GETListar conversasGETListar conversas de um membroPOSTMudar status da conversaPOSTResolver conversaPATCHAtribuir conversaPOSTEtiquetar conversaDELTirar etiqueta da conversaPOSTAdicionar anotação privada

    Mensagens e contatos

    GETListar mensagens de um contatoGETListar mensagens de um grupoGETBaixar mídia da mensagemGETGerar URL de download da mídiaPATCHAtualizar contato

    Envio

    POSTEnviar mensagemPOSTSubir mídiaPUTEditar mensagemPOSTIniciar conversa

    Etiquetas

    GETListar etiquetasGETBuscar etiquetaPOSTCriar etiquetaPUTEditar etiquetaDELApagar etiqueta

    Grupos

    GETDetalhes do grupoGETLink de convite do grupoPOSTCriar grupoPOSTConvidar pessoas para um grupoPOSTGerenciar participantesPOSTRenomear grupoPOSTMudar descrição do grupoPOSTMudar foto do grupo

    Etiquetas

    Buscar etiqueta

    GEThttps://api.batzap.com/v1/tags/{tag_id}

    Devolve uma etiqueta.

    Escopo
    chats:read
    Limite de uso
    Leitura · 120/min

    Parâmetros de caminho

    tag_iduuidobrigatório

    Id da etiqueta.

    Erros

    404
    Tag not found (etiqueta não encontrada).

    Além dos erros que qualquer rota pode devolver: veja Erros.

    AnteriorListar etiquetasPróximo Criar etiqueta
    curl -X GET "https://api.batzap.com/v1/tags/8c4e2a6f-1d3b-4f5a-9e7c-0b2d4f6a8c13" \
      -H "Authorization: bzp_live_SUA_CHAVE_DE_API"
    Resposta 200
    {
      "success": true,
      "data": {
        "tag": {
          "id": "8c4e2a6f-1d3b-4f5a-9e7c-0b2d4f6a8c13",
          "name": "VIP",
          "color": "#16a34a",
          "created_at": "2026-08-01T10:00:00Z",
          "updated_at": "2026-08-01T10:00:00Z"
        }
      }
    }