{ "info": { "name": "HookCloud Partner API · Graph v26 e BSUID", "_postman_id": "8443c480-4d00-433c-aeb1-d3aee418ec8f", "description": "API do Partner em produção e operações diretas Meta Graph v26.0. Cada requisição é executada manualmente. A Partner API Key autentica o Partner; meta_access_token autentica somente a Graph. BSUID é enviado no campo recipient. Para homologação, altere api_url para https://api-stage.hookcloud.app/functions/v1/swift-worker e use a API Key do stage. Requisições em produção modificam dados reais.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "variable": [ { "key": "api_url", "value": "https://api.hookcloud.app/functions/v1/swift-worker" }, { "key": "publishable_key", "value": "SUA_PUBLISHABLE_KEY" }, { "key": "partner_api_key", "value": "hc_partner_live_SUA_CHAVE" }, { "key": "member_jwt", "value": "JWT_DO_USUARIO_LOGADO" }, { "key": "customer_id", "value": "UUID_DO_CLIENTE" }, { "key": "external_customer_id", "value": "cliente_56790" }, { "key": "instance_id", "value": "UUID_DA_INSTANCIA" }, { "key": "instance_key", "value": "cliente_56790-whatsapp1" }, { "key": "phone_number_id", "value": "PHONE_NUMBER_ID" }, { "key": "waba_id", "value": "WABA_ID" }, { "key": "api_url_production", "value": "https://api.hookcloud.app/functions/v1/swift-worker" }, { "key": "graph_url", "value": "https://graph.facebook.com/v26.0" }, { "key": "meta_access_token", "value": "META_ACCESS_TOKEN_NO_SEU_AMBIENTE_PRIVADO" }, { "key": "recipient_bsuid", "value": "BR.BSUID_RECEBIDO_DA_META" }, { "key": "template_id", "value": "TEMPLATE_ID" }, { "key": "template_name", "value": "confirmacao_agendamento" }, { "key": "media_id", "value": "MEDIA_ID" }, { "key": "message_id", "value": "wamid.DA_MENSAGEM_RECEBIDA" }, { "key": "business_username", "value": "nome_da_empresa" } ], "item": [ { "name": "Clientes", "item": [ { "name": "Criar/atualizar cliente", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=upsert-partner-customer", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "upsert-partner-customer" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"upsert-partner-customer\",\n \"external_customer_id\": \"{{external_customer_id}}\",\n \"customer_name\": \"Clínica Mais Vida\",\n \"customer_email\": \"contato@maisvida.com\",\n \"customer_phone\": \"5511999999999\",\n \"metadata\": {\n \"origem\": \"postman\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Listar clientes", "request": { "method": "GET", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=list-partner-customers", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "list-partner-customers" }, { "key": "page", "value": "1" }, { "key": "page_size", "value": "50" }, { "key": "status", "value": "active" }, { "key": "search", "value": "" } ] }, "description": "" }, "response": [] }, { "name": "Consultar cliente", "request": { "method": "GET", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=get-partner-customer", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "get-partner-customer" }, { "key": "external_customer_id", "value": "{{external_customer_id}}" } ] }, "description": "" }, "response": [] }, { "name": "Editar cliente", "request": { "method": "PATCH", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=update-partner-customer", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "update-partner-customer" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"update-partner-customer\",\n \"customer_id\": \"{{customer_id}}\",\n \"changes\": {\n \"customer_name\": \"Clínica Mais Vida\",\n \"customer_email\": \"contato@maisvida.com\",\n \"customer_phone\": \"5511999999999\"\n },\n \"expected_updated_at\": \"2026-07-23T12:00:00Z\",\n \"reason\": \"Correção cadastral\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Histórico", "request": { "method": "GET", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=get-partner-customer-history", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "get-partner-customer-history" }, { "key": "customer_id", "value": "{{customer_id}}" }, { "key": "page", "value": "1" }, { "key": "page_size", "value": "50" } ] }, "description": "" }, "response": [] }, { "name": "Mesclar clientes", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=merge-partner-customers", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "merge-partner-customers" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"merge-partner-customers\",\n \"source_customer_id\": \"UUID_DUPLICADO\",\n \"target_customer_id\": \"{{customer_id}}\",\n \"reason\": \"Cadastro duplicado\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Mover instância", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=move-partner-instance-to-customer", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "move-partner-instance-to-customer" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"move-partner-instance-to-customer\",\n \"instance_id\": \"{{instance_id}}\",\n \"target_customer_id\": \"{{customer_id}}\",\n \"reason\": \"Correção de vínculo\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Inativar cliente", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=deactivate-partner-customer", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "deactivate-partner-customer" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"deactivate-partner-customer\",\n \"external_customer_id\": \"{{external_customer_id}}\",\n \"reason\": \"Cliente cancelou assinatura\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Reativar cliente", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=reactivate-partner-customer", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "reactivate-partner-customer" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"reactivate-partner-customer\",\n \"external_customer_id\": \"{{external_customer_id}}\",\n \"reason\": \"Cliente retornou\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Inativar cliente (DELETE)", "request": { "method": "DELETE", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=deactivate-partner-customer", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "deactivate-partner-customer" } ] }, "description": "Inativação lógica com remoção remota protegida, sem exclusão física do cadastro. Mesma operação do POST.", "body": { "mode": "raw", "raw": "{\n \"route\": \"deactivate-partner-customer\",\n \"external_customer_id\": \"{{external_customer_id}}\",\n \"reason\": \"Cliente cancelou assinatura\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "Instâncias", "item": [ { "name": "Listar instâncias", "request": { "method": "GET", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=list-partner-instances&page=1&page_size=50&external_customer_id={{external_customer_id}}", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "list-partner-instances" }, { "key": "page", "value": "1" }, { "key": "page_size", "value": "50" }, { "key": "external_customer_id", "value": "{{external_customer_id}}" } ] } }, "response": [] }, { "name": "Criar instância", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=create-customer-instance", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "create-customer-instance" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"create-customer-instance\",\n \"external_customer_id\": \"{{external_customer_id}}\",\n \"instance_key\": \"{{instance_key}}\",\n \"instance_name\": \"WhatsApp principal\",\n \"create_connect_session\": true,\n \"return_url\": \"https://app.seusistema.com/integracoes/whatsapp\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Gerar reconnect", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=create-connect-session", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "create-connect-session" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"create-connect-session\",\n \"instance_id\": \"{{instance_id}}\",\n \"mode\": \"reconnect\",\n \"return_url\": \"https://app.seusistema.com/integracoes/whatsapp\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Consultar instância", "request": { "method": "GET", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=get-partner-instance", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "get-partner-instance" }, { "key": "instance_id", "value": "{{instance_id}}" } ] }, "description": "" }, "response": [] }, { "name": "Atualizar dados Meta", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=refresh-partner-instance-meta", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "refresh-partner-instance-meta" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"refresh-partner-instance-meta\",\n \"instance_id\": \"{{instance_id}}\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Editar apelido", "request": { "method": "PATCH", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=update-partner-instance-label", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "update-partner-instance-label" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"update-partner-instance-label\",\n \"instance_id\": \"{{instance_id}}\",\n \"instance_name\": \"Atendimento comercial\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Revelar token Meta", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=reveal-partner-instance-meta-token", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "reveal-partner-instance-meta-token" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"reveal-partner-instance-meta-token\",\n \"instance_id\": \"{{instance_id}}\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Inativar instância", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=deactivate-partner-instance", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "deactivate-partner-instance" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"deactivate-partner-instance\",\n \"instance_id\": \"{{instance_id}}\",\n \"reason\": \"Cliente cancelou a linha\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Inativar instância (DELETE)", "request": { "method": "DELETE", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=deactivate-partner-instance", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "deactivate-partner-instance" } ] }, "description": "Inativação lógica com remoção remota protegida, sem exclusão física do cadastro. Mesma operação do POST.", "body": { "mode": "raw", "raw": "{\n \"route\": \"deactivate-partner-instance\",\n \"instance_id\": \"{{instance_id}}\",\n \"reason\": \"Cliente cancelou a linha\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "Webhooks", "item": [ { "name": "Consultar endpoint", "request": { "method": "GET", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=get-partner-webhook-endpoint", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "get-partner-webhook-endpoint" } ] } }, "response": [] }, { "name": "Validar endpoint", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=validate-partner-webhook-endpoint", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "validate-partner-webhook-endpoint" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"validate-partner-webhook-endpoint\",\n \"webhook_url\": \"https://api.seusistema.com/webhooks/whatsapp\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Alterar endpoint", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=update-partner-webhook-endpoint", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "update-partner-webhook-endpoint" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"update-partner-webhook-endpoint\",\n \"webhook_url\": \"https://api.seusistema.com/webhooks/whatsapp\",\n \"reason\": \"Migração de domínio\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Consultar migração", "request": { "method": "GET", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=get-partner-webhook-migration", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "get-partner-webhook-migration" } ] }, "description": "" }, "response": [] }, { "name": "Reprocessar migração", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=retry-partner-webhook-migration", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "retry-partner-webhook-migration" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"retry-partner-webhook-migration\",\n \"migration_id\": \"UUID_DA_MIGRACAO\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "Templates", "item": [ { "name": "Listar templates", "request": { "method": "GET", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=list-partner-meta-templates", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "list-partner-meta-templates" }, { "key": "instance_id", "value": "{{instance_id}}" }, { "key": "status", "value": "APPROVED" }, { "key": "sendable_only", "value": "true" }, { "key": "page", "value": "1" }, { "key": "page_size", "value": "50" } ] }, "description": "" }, "response": [] }, { "name": "Consultar template", "request": { "method": "GET", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=get-partner-meta-template", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "get-partner-meta-template" }, { "key": "instance_id", "value": "{{instance_id}}" }, { "key": "template_name", "value": "confirmacao_agendamento" }, { "key": "language", "value": "pt_BR" } ] }, "description": "" }, "response": [] }, { "name": "Atualizar catálogo", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=refresh-partner-meta-templates", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "refresh-partner-meta-templates" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"refresh-partner-meta-templates\",\n \"instance_id\": \"{{instance_id}}\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Consultar sync", "request": { "method": "GET", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=get-partner-meta-template-sync", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "get-partner-meta-template-sync" }, { "key": "instance_id", "value": "{{instance_id}}" } ] }, "description": "" }, "response": [] } ] }, { "name": "Saúde de Entregas", "item": [ { "name": "Reportar delivered", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=report-partner-message-status", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "report-partner-message-status" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"report-partner-message-status\",\n \"phone_number_id\": \"{{phone_number_id}}\",\n \"message_id\": \"wamid.xxxxx\",\n \"status\": \"delivered\",\n \"occurred_at\": \"1789055123\",\n \"recipient_user_id\": \"{{recipient_bsuid}}\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Reportar 131049", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=report-partner-message-delivery-failure", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "report-partner-message-delivery-failure" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"report-partner-message-delivery-failure\",\n \"phone_number_id\": \"{{phone_number_id}}\",\n \"message_id\": \"wamid.xxxxx\",\n \"template_name\": \"campanha_marketing\",\n \"campaign_id\": \"campanha_456\",\n \"error_code\": 131049,\n \"error_title\": \"Healthy ecosystem engagement\",\n \"recipient_hash\": \"HMAC_SHA256_HEX_COM_64_CARACTERES\",\n \"occurred_at\": \"2026-07-21T12:00:00Z\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Reportar 131042 sem waMID", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=report-partner-message-delivery-failure", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "report-partner-message-delivery-failure" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"report-partner-message-delivery-failure\",\n \"phone_number_id\": \"{{phone_number_id}}\",\n \"client_message_id\": \"msg_local_123\",\n \"error_code\": 131042,\n \"error_title\": \"Business eligibility/payment issue\",\n \"occurred_at\": \"2026-07-21T12:00:00Z\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Resumo de saúde", "request": { "method": "GET", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=get-partner-delivery-health", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "get-partner-delivery-health" }, { "key": "window_hours", "value": "24" } ] }, "description": "" }, "response": [] }, { "name": "Pesquisar eventos", "request": { "method": "GET", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{partner_api_key}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=search-partner-delivery-events", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "search-partner-delivery-events" }, { "key": "status", "value": "failed" }, { "key": "error_code", "value": "131049" }, { "key": "page", "value": "1" }, { "key": "page_size", "value": "50" }, { "key": "sort", "value": "desc" } ] }, "description": "" }, "response": [] } ] }, { "name": "Notificações do Portal", "item": [ { "name": "Listar notificações", "request": { "method": "GET", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{member_jwt}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=list-partner-notifications", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "list-partner-notifications" }, { "key": "limit", "value": "40" } ] }, "description": "" }, "response": [] }, { "name": "Consultar preferências", "request": { "method": "GET", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{member_jwt}}", "type": "text" } ], "url": { "raw": "{{api_url}}?route=get-partner-notification-preferences", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "get-partner-notification-preferences" } ] }, "description": "" }, "response": [] }, { "name": "Atualizar preferências", "request": { "method": "PATCH", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{member_jwt}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=update-partner-notification-preferences", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "update-partner-notification-preferences" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"update-partner-notification-preferences\",\n \"notify_academy\": true,\n \"notify_meta_alerts\": true,\n \"notify_templates\": true,\n \"notify_delivery_health\": true,\n \"notify_billing\": true,\n \"notify_billing_reminders\": true,\n \"notify_system\": true,\n \"popup_enabled\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Marcar como lida", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{member_jwt}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=mark-partner-notification-read", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "mark-partner-notification-read" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"mark-partner-notification-read\",\n \"notification_id\": \"UUID_DA_NOTIFICACAO\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Marcar todas como lidas", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{publishable_key}}", "type": "text" }, { "key": "Authorization", "value": "Bearer {{member_jwt}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{api_url}}?route=mark-all-partner-notifications-read", "host": [ "{{api_url}}" ], "query": [ { "key": "route", "value": "mark-all-partner-notifications-read" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"route\": \"mark-all-partner-notifications-read\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "Meta Graph · Mensagens e BSUID", "item": [ { "name": "Enviar texto por BSUID", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": "{{graph_url}}/{{phone_number_id}}/messages", "description": "POST real. recipient recebe BSUID; não enviar user_id nem username. Se usar to, ele deve ser telefone.", "body": { "mode": "raw", "raw": "{\n \"messaging_product\": \"whatsapp\",\n \"recipient_type\": \"individual\",\n \"recipient\": \"{{recipient_bsuid}}\",\n \"type\": \"text\",\n \"text\": {\n \"preview_url\": false,\n \"body\": \"Olá! Como podemos ajudar?\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Enviar template por BSUID", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": "{{graph_url}}/{{phone_number_id}}/messages", "description": "", "body": { "mode": "raw", "raw": "{\n \"messaging_product\": \"whatsapp\",\n \"recipient\": \"{{recipient_bsuid}}\",\n \"type\": \"template\",\n \"template\": {\n \"name\": \"confirmacao_agendamento\",\n \"language\": {\n \"code\": \"pt_BR\"\n },\n \"components\": [\n {\n \"type\": \"body\",\n \"parameters\": [\n {\n \"type\": \"text\",\n \"text\": \"Ana\"\n },\n {\n \"type\": \"text\",\n \"text\": \"15/09 às 15h\"\n }\n ]\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Enviar imagem por ID", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": "{{graph_url}}/{{phone_number_id}}/messages", "description": "", "body": { "mode": "raw", "raw": "{\n \"messaging_product\": \"whatsapp\",\n \"recipient\": \"{{recipient_bsuid}}\",\n \"type\": \"image\",\n \"image\": {\n \"id\": \"{{media_id}}\",\n \"caption\": \"Imagem solicitada\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Marcar mensagem recebida como lida", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": "{{graph_url}}/{{phone_number_id}}/messages", "description": "", "body": { "mode": "raw", "raw": "{\n \"messaging_product\": \"whatsapp\",\n \"status\": \"read\",\n \"message_id\": \"{{message_id}}\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "Meta Graph · Mídia", "item": [ { "name": "Upload de mídia", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" } ], "url": "{{graph_url}}/{{phone_number_id}}/media", "description": "", "body": { "mode": "formdata", "formdata": [ { "key": "messaging_product", "value": "whatsapp", "type": "text" }, { "key": "file", "type": "file", "src": [] } ] } }, "response": [] }, { "name": "Obter metadados e URL temporária", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" } ], "url": "{{graph_url}}/{{media_id}}?phone_number_id={{phone_number_id}}", "description": "" }, "response": [] }, { "name": "Excluir mídia", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" } ], "url": "{{graph_url}}/{{media_id}}?phone_number_id={{phone_number_id}}", "description": "Exclusão real do arquivo Meta selecionado." }, "response": [] } ] }, { "name": "Meta Graph · Templates CRUD", "item": [ { "name": "Listar templates na WABA", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" } ], "url": "{{graph_url}}/{{waba_id}}/message_templates?fields=id,name,language,status,category,components,parameter_format&limit=50", "description": "" }, "response": [] }, { "name": "Consultar template por ID", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" } ], "url": "{{graph_url}}/{{template_id}}?fields=id,name,language,status,category,components,parameter_format", "description": "" }, "response": [] }, { "name": "Criar template de utilidade", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": "{{graph_url}}/{{waba_id}}/message_templates", "description": "", "body": { "mode": "raw", "raw": "{\n \"name\": \"confirmacao_agendamento\",\n \"language\": \"pt_BR\",\n \"category\": \"utility\",\n \"parameter_format\": \"positional\",\n \"components\": [\n {\n \"type\": \"body\",\n \"text\": \"Olá, {{1}}! Seu agendamento está confirmado para {{2}}.\",\n \"example\": {\n \"body_text\": [\n [\n \"Ana\",\n \"15/09 às 15h\"\n ]\n ]\n }\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Editar todos os componentes do template", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": "{{graph_url}}/{{template_id}}", "description": "Substitui todos os componentes. Preservar o conjunto completo que deseja manter.", "body": { "mode": "raw", "raw": "{\n \"components\": [\n {\n \"type\": \"BODY\",\n \"text\": \"Olá, {{1}}! Confirmamos seu atendimento em {{2}}.\",\n \"example\": {\n \"body_text\": [\n [\n \"Ana\",\n \"15/09 às 15h\"\n ]\n ]\n }\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Excluir template por nome e ID", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" } ], "url": "{{graph_url}}/{{waba_id}}/message_templates?name={{template_name}}&hsm_id={{template_id}}", "description": "Exclusão real. Nome sem hsm_id excluiria todos os idiomas com o mesmo nome." }, "response": [] } ] }, { "name": "Meta Graph · Username comercial", "item": [ { "name": "Consultar username atual", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" } ], "url": "{{graph_url}}/{{phone_number_id}}/username", "description": "" }, "response": [] }, { "name": "Consultar usernames reservados", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" } ], "url": "{{graph_url}}/{{phone_number_id}}/username_suggestions", "description": "" }, "response": [] }, { "name": "Reivindicar ou alterar username", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": "{{graph_url}}/{{phone_number_id}}/username", "description": "Aprovação e elegibilidade dependem da Meta. reserved não significa já ativo. Não transfere nome de outro número.", "body": { "mode": "raw", "raw": "{\n \"username\": \"{{business_username}}\",\n \"transfer_action\": \"none\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Remover username comercial", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{meta_access_token}}", "type": "text" } ], "url": "{{graph_url}}/{{phone_number_id}}/username", "description": "Remoção real do nome comercial selecionado; não é remoção de um destinatário BSUID." }, "response": [] } ] } ] }