Ajuda IntegraĆ§Ć£o Zap

ReferĆŖncia da API

šŸ¢ Tenant API

POST /tenantCreateApi

CreateApi

{"openapi":"3.0.3","info":{"title":"Ajuda IntegraĆ§Ć£o Zap ā€” API Externa","version":"v4.x.x.x"},"tags":[{"name":"šŸ¢ Tenant API"}],"servers":[{"url":"https://{baseUrl}","description":"InstalaĆ§Ć£o Ajuda IntegraĆ§Ć£o Zap do cliente","variables":{"baseUrl":{"default":"api.seudominio.com.br","description":"DomĆ­nio do backend Ajuda IntegraĆ§Ć£o Zap, sem protocolo e sem barra final."}}}],"security":[{"superAdminAuth":[]}],"components":{"securitySchemes":{"superAdminAuth":{"type":"http","scheme":"bearer","description":"Token de super admin, exigido pelas rotas de Tenant API (na coleĆ§Ć£o Postman: `SuperAdminToken`)."}}},"paths":{"/tenantCreateApi":{"post":{"tags":["šŸ¢ Tenant API"],"summary":"CreateApi","operationId":"CreateApi","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome da API que serĆ” criada"},"sessionId":{"type":"integer","description":"ID da sessĆ£o do WhatsApp associada"},"urlServiceStatus":{"type":"string","description":"URL para receber atualizaƧƵes de status do serviƧo (opcional)","nullable":true},"urlMessageStatus":{"type":"string","description":"URL para receber atualizaƧƵes de status das mensagens (opcional)","nullable":true},"userId":{"type":"integer","description":"ID do usuĆ”rio que estĆ” criando a API"},"authToken":{"type":"string","description":"Token de autenticaĆ§Ć£o para a API"},"tenant":{"type":"integer","description":"ID do tenant que terĆ” a API"}}}}}},"responses":{"200":{"description":"RequisiĆ§Ć£o processada com sucesso.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"ParĆ¢metros invĆ”lidos ou faltando."},"401":{"description":"Token ausente, invĆ”lido ou sem permissĆ£o."}}}}}}

CreateSessionTenant

Endpoint com mais de um formato de payload na coleĆ§Ć£o oficial: **CreateSessionTenant**, **CreateSessionTenant (HĆ­brido)**. Veja os exemplos do corpo para escolher a variante.

{"openapi":"3.0.3","info":{"title":"Ajuda IntegraĆ§Ć£o Zap ā€” API Externa","version":"v4.x.x.x"},"tags":[{"name":"šŸ¢ Tenant API"}],"servers":[{"url":"https://{baseUrl}","description":"InstalaĆ§Ć£o Ajuda IntegraĆ§Ć£o Zap do cliente","variables":{"baseUrl":{"default":"api.seudominio.com.br","description":"DomĆ­nio do backend Ajuda IntegraĆ§Ć£o Zap, sem protocolo e sem barra final."}}}],"security":[{"superAdminAuth":[]}],"components":{"securitySchemes":{"superAdminAuth":{"type":"http","scheme":"bearer","description":"Token de super admin, exigido pelas rotas de Tenant API (na coleĆ§Ć£o Postman: `SuperAdminToken`)."}}},"paths":{"/tenantApiCreateSession":{"post":{"tags":["šŸ¢ Tenant API"],"summary":"CreateSessionTenant","operationId":"CreateSessionTenant","description":"Endpoint com mais de um formato de payload na coleĆ§Ć£o oficial: **CreateSessionTenant**, **CreateSessionTenant (HĆ­brido)**. Veja os exemplos do corpo para escolher a variante.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tenant":{"type":"integer","description":"Tenant"},"name":{"type":"string","description":"Nome da instĆ¢ncia do WhatsApp"},"status":{"type":"string","description":"Status inicial da sessĆ£o (DISCONNECTED, CONNECTED)"},"type":{"type":"string","description":"Tipo da sessĆ£o (whatsapp, baileys, zapo, meow, evo, uazapi, zapi)"}}}}}},"responses":{"200":{"description":"RequisiĆ§Ć£o processada com sucesso.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"ParĆ¢metros invĆ”lidos ou faltando."},"401":{"description":"Token ausente, invĆ”lido ou sem permissĆ£o."}}}}}}

POST /tenantDeleteApi

DeleteApi

{"openapi":"3.0.3","info":{"title":"Ajuda IntegraĆ§Ć£o Zap ā€” API Externa","version":"v4.x.x.x"},"tags":[{"name":"šŸ¢ Tenant API"}],"servers":[{"url":"https://{baseUrl}","description":"InstalaĆ§Ć£o Ajuda IntegraĆ§Ć£o Zap do cliente","variables":{"baseUrl":{"default":"api.seudominio.com.br","description":"DomĆ­nio do backend Ajuda IntegraĆ§Ć£o Zap, sem protocolo e sem barra final."}}}],"security":[{"superAdminAuth":[]}],"components":{"securitySchemes":{"superAdminAuth":{"type":"http","scheme":"bearer","description":"Token de super admin, exigido pelas rotas de Tenant API (na coleĆ§Ć£o Postman: `SuperAdminToken`)."}}},"paths":{"/tenantDeleteApi":{"post":{"tags":["šŸ¢ Tenant API"],"summary":"DeleteApi","operationId":"DeleteApi","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sessionId":{"type":"integer","description":"ID da sessĆ£o do WhatsApp associada Ć  API"},"userId":{"type":"integer","description":"ID do usuĆ”rio que estĆ” deletando a API"},"tenant":{"type":"integer","description":"ID do tenant que possui a API"},"apiId":{"type":"string","description":"ID da API que serĆ” deletada"}}}}}},"responses":{"200":{"description":"RequisiĆ§Ć£o processada com sucesso.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"ParĆ¢metros invĆ”lidos ou faltando."},"401":{"description":"Token ausente, invĆ”lido ou sem permissĆ£o."}}}}}}

GET /tenantApiListTenants

ListTenants

{"openapi":"3.0.3","info":{"title":"Ajuda IntegraĆ§Ć£o Zap ā€” API Externa","version":"v4.x.x.x"},"tags":[{"name":"šŸ¢ Tenant API"}],"servers":[{"url":"https://{baseUrl}","description":"InstalaĆ§Ć£o Ajuda IntegraĆ§Ć£o Zap do cliente","variables":{"baseUrl":{"default":"api.seudominio.com.br","description":"DomĆ­nio do backend Ajuda IntegraĆ§Ć£o Zap, sem protocolo e sem barra final."}}}],"security":[{"superAdminAuth":[]}],"components":{"securitySchemes":{"superAdminAuth":{"type":"http","scheme":"bearer","description":"Token de super admin, exigido pelas rotas de Tenant API (na coleĆ§Ć£o Postman: `SuperAdminToken`)."}}},"paths":{"/tenantApiListTenants":{"get":{"tags":["šŸ¢ Tenant API"],"summary":"ListTenants","operationId":"ListTenants","responses":{"200":{"description":"RequisiĆ§Ć£o processada com sucesso.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"ParĆ¢metros invĆ”lidos ou faltando."},"401":{"description":"Token ausente, invĆ”lido ou sem permissĆ£o."}}}}}}

POST /tenantApiShowTenant

ShowTenant

{"openapi":"3.0.3","info":{"title":"Ajuda IntegraĆ§Ć£o Zap ā€” API Externa","version":"v4.x.x.x"},"tags":[{"name":"šŸ¢ Tenant API"}],"servers":[{"url":"https://{baseUrl}","description":"InstalaĆ§Ć£o Ajuda IntegraĆ§Ć£o Zap do cliente","variables":{"baseUrl":{"default":"api.seudominio.com.br","description":"DomĆ­nio do backend Ajuda IntegraĆ§Ć£o Zap, sem protocolo e sem barra final."}}}],"security":[{"superAdminAuth":[]}],"components":{"securitySchemes":{"superAdminAuth":{"type":"http","scheme":"bearer","description":"Token de super admin, exigido pelas rotas de Tenant API (na coleĆ§Ć£o Postman: `SuperAdminToken`)."}}},"paths":{"/tenantApiShowTenant":{"post":{"tags":["šŸ¢ Tenant API"],"summary":"ShowTenant","operationId":"ShowTenant","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"ID do tenant que serĆ” consultado"}}}}}},"responses":{"200":{"description":"RequisiĆ§Ć£o processada com sucesso.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"ParĆ¢metros invĆ”lidos ou faltando."},"401":{"description":"Token ausente, invĆ”lido ou sem permissĆ£o."}}}}}}

POST /tenantApiStoreTenant

StoreTenant

{"openapi":"3.0.3","info":{"title":"Ajuda IntegraĆ§Ć£o Zap ā€” API Externa","version":"v4.x.x.x"},"tags":[{"name":"šŸ¢ Tenant API"}],"servers":[{"url":"https://{baseUrl}","description":"InstalaĆ§Ć£o Ajuda IntegraĆ§Ć£o Zap do cliente","variables":{"baseUrl":{"default":"api.seudominio.com.br","description":"DomĆ­nio do backend Ajuda IntegraĆ§Ć£o Zap, sem protocolo e sem barra final."}}}],"security":[{"superAdminAuth":[]}],"components":{"securitySchemes":{"superAdminAuth":{"type":"http","scheme":"bearer","description":"Token de super admin, exigido pelas rotas de Tenant API (na coleĆ§Ć£o Postman: `SuperAdminToken`)."}}},"paths":{"/tenantApiStoreTenant":{"post":{"tags":["šŸ¢ Tenant API"],"summary":"StoreTenant","operationId":"StoreTenant","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Status do tenant (active, inactive)"},"name":{"type":"string","description":"Nome da empresa/tenant"},"maxUsers":{"type":"integer","description":"NĆŗmero mĆ”ximo de usuĆ”rios permitidos"},"maxConnections":{"type":"integer","description":"NĆŗmero mĆ”ximo de conexƵes WhatsApp permitidas"},"acceptTerms":{"type":"boolean","description":"ConfirmaĆ§Ć£o de aceite dos termos"},"email":{"type":"string","description":"Email do administrador do tenant"},"password":{"type":"string","description":"Senha do administrador (mĆ­nimo 8 caracteres, incluindo nĆŗmeros e caracteres especiais)"},"userName":{"type":"string","description":"Nome completo do administrador"},"profile":{"type":"string","description":"Perfil do administrador (admin, user)"},"paymentGateway":{"type":"string","description":"Vinculo de gateway de pagamento (OPCIONAL). Define qual gateway o webhook usa para atualizar o status de pagamento do tenant automaticamente. Valores: asaas, stripe, pagarme, mercadopago."},"stripeCustomerId":{"type":"string","description":"Credenciais do gateway informado acima (envie apenas o par do gateway escolhido). Exemplo Stripe: Customer ID + Secret Key."},"stripeToken":{"type":"string"}}}}}},"responses":{"200":{"description":"RequisiĆ§Ć£o processada com sucesso.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"ParĆ¢metros invĆ”lidos ou faltando."},"401":{"description":"Token ausente, invĆ”lido ou sem permissĆ£o."}}}}}}

POST /tenantApiUpdateTenant

UpdateTenant

{"openapi":"3.0.3","info":{"title":"Ajuda IntegraĆ§Ć£o Zap ā€” API Externa","version":"v4.x.x.x"},"tags":[{"name":"šŸ¢ Tenant API"}],"servers":[{"url":"https://{baseUrl}","description":"InstalaĆ§Ć£o Ajuda IntegraĆ§Ć£o Zap do cliente","variables":{"baseUrl":{"default":"api.seudominio.com.br","description":"DomĆ­nio do backend Ajuda IntegraĆ§Ć£o Zap, sem protocolo e sem barra final."}}}],"security":[{"superAdminAuth":[]}],"components":{"securitySchemes":{"superAdminAuth":{"type":"http","scheme":"bearer","description":"Token de super admin, exigido pelas rotas de Tenant API (na coleĆ§Ć£o Postman: `SuperAdminToken`)."}}},"paths":{"/tenantApiUpdateTenant":{"post":{"tags":["šŸ¢ Tenant API"],"summary":"UpdateTenant","operationId":"UpdateTenant","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"identity":{"type":"string","description":"Identidade do tenant (CPF/CNPJ) - identificador usado para reconhecer qual tenant serĆ” atualizado"},"status":{"type":"string","description":"Status do tenant (active, inactive)"},"maxUsers":{"type":"integer","description":"NĆŗmero mĆ”ximo de usuĆ”rios permitidos"},"maxConnections":{"type":"integer","description":"NĆŗmero mĆ”ximo de conexƵes permitidas"},"paymentGateway":{"type":"string","description":"Gateway de pagamento (none, asaas, mercadopago, stripe, pagarme)"},"supportChatEnabled":{"type":"string","description":"Credenciais do gateway (OPCIONAL) ā€” envie o par correspondente ao paymentGateway. Ao trocar para um gateway nao-Asaas, o modo Asaas legado e desligado automaticamente. Stripe:       \"stripeCustomerId\": \"cus_xxx\",      \"stripeToken\": \"sk_live_xxx\" Pagar.me:     \"pagarmeCustomerId\": \"cus_xxx\",     \"pagarmeToken\": \"sk_xxx\" Mercado Pago: \"mercadopagoCustomerId\": \"123456\",  \"mercadopagoToken\": \"APP_USR-xxx\" Chat de suporte habilitado (enabled, disabled)"},"menuVisibility":{"type":"array","description":"Menus visĆ­veis ā€” array de strings com os menus habilitados OpƧƵes: Groups, MassDispatch, Kanban, Tasks, Api, ChatBot, Reports, Campaigns, PrivateChat, Teams, AllowedChannels","items":{"type":"string"}},"allowedChannels":{"type":"array","description":"Canais permitidos ā€” array de strings com os canais habilitados OpƧƵes: waba, baileys, zapo, whatsapp, meow, evo, zapi, uazapi, telegram, hub, webchat, webmail, wabaoauth, instagramoauth, facebookoauth","items":{"type":"string"}},"channelConnectionLimits":{"type":"object","description":"Limite mĆ”ximo de conexƵes por tipo de canal. Use 0 para ilimitado.","properties":{"waba":{"type":"integer"},"baileys":{"type":"integer"},"zapo":{"type":"integer"},"whatsapp":{"type":"integer"},"meow":{"type":"integer"},"evo":{"type":"integer"},"zapi":{"type":"integer"},"uazapi":{"type":"integer"},"telegram":{"type":"integer"},"hub":{"type":"integer"},"webchat":{"type":"integer"},"webmail":{"type":"integer"},"wabaoauth":{"type":"integer"},"instagramoauth":{"type":"integer"},"facebookoauth":{"type":"integer"}}},"oauthEnabled":{"type":"boolean","description":"OAuth (Meta Embedded Signup) OAuth habilitado (true/false)"},"oauthProxyUrl":{"type":"string","description":"URL do Proxy OAuth"},"instagramWebhookProxyUrl":{"type":"string","description":"URL do Proxy de Webhook Instagram"},"instagramWebhookProxySecret":{"type":"string","description":"Segredo do Proxy Instagram"},"messengerWebhookProxyUrl":{"type":"string","description":"URL do Proxy de Webhook Messenger"},"messengerWebhookProxySecret":{"type":"string","description":"Segredo do Proxy Messenger"}}}}}},"responses":{"200":{"description":"RequisiĆ§Ć£o processada com sucesso.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"ParĆ¢metros invĆ”lidos ou faltando."},"401":{"description":"Token ausente, invĆ”lido ou sem permissĆ£o."}}}}}}