# Índice de referência de métodos da API

import { Badge } from '@astrojs/starlight/components';

A Pushwoosh oferece uma vasta biblioteca com mais de 100 métodos de API, categorizados para diversas funcionalidades, como envio de notificações, gerenciamento de usuários e acompanhamento de análises.




## API de Mensagens v2

API unificada que substitui toda a família `/create*Message` (push, e-mail, SMS, Kakao). Consulte a [visão geral](/pt/developer/api-reference/messaging-api-v2/) e o [guia de migração](/pt/developer/api-reference/messaging-api-v2/migration-from-v1/).

|    <div style="width:250px"></div>                                                            |                                                                                                     |
|-------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|
| [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/)             | Cria e envia uma única mensagem por qualquer canal. Substitui `/createMessage`, `/createTargetedMessage`, `/createEmailMessage`, `/createSMSMessage`, `/createKakaoMessage`. |
| [`Cancel`](/pt/developer/api-reference/messaging-api-v2/cancel/)             | Cancela uma mensagem criada anteriormente antes de ser entregue. Use com `message_code` de [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/). |
| [`Update`](/pt/developer/api-reference/messaging-api-v2/update/)             | Substitui uma mensagem ainda agendada por uma nova definição (substituição completa). Use com `message_code` de [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/). |

## Gateway SMTP

Envie e-mails transacionais por SMTP padrão em vez de chamar a API diretamente. O gateway se autentica com o código do seu aplicativo e o token da API e, em seguida, encaminha cada mensagem para [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/). Consulte a [referência do gateway SMTP](/pt/developer/api-reference/smtp-gateway/).

## API de Mensagens


|    <div style="width:250px"></div>                                                            |                                                                                                     |
|-------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|
| [`createMessage`](/pt/developer/api-reference/messages-api#createmessage) <Badge text="Obsoleto" variant="caution" size="small" />   | Cria uma nova notificação push. Use [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/) em vez disso. |
| [`deleteMessage`](/pt/developer/api-reference/messages-api#deletemessage)   | Exclui uma mensagem agendada.                                                                                    |
| [`getMessageDetails`](/pt/developer/api-reference/messages-api#getmessagedetails) | Recupera os detalhes da mensagem.                                                                             |
| [`createTargetedMessage`](/pt/developer/api-reference/messages-api#createtargetedmessage) <Badge text="Obsoleto" variant="caution" size="small" /> | Cria uma nova notificação push direcionada. Use [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/) com o tipo `transactional` em vez disso. |
| [`getPushHistory`](/pt/developer/api-reference/messages-api#getpushhistory) <Badge text="Obsoleto" variant="caution" size="small" /> | Use [`/messages:list`](/pt/developer/api-reference/statistics-api/message-statistics-api/#messageslist) para recuperar o histórico de mensagens com dados detalhados. |
| [`cancelMessage`](/pt/developer/api-reference/messages-api#cancelmessage)   | Cancela uma mensagem agendada.                                                                                   |


## API de Predefinições

|                 <div style="width:250px"></div>                                              |                                                                                     |
|------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|
| [`createPreset`](/pt/developer/api-reference/presets-api#createpreset)      | Cria uma nova predefinição.                                                                          |
| [`getPreset`](/pt/developer/api-reference/presets-api#getpreset)            | Recupera os parâmetros da predefinição de push especificada.                                            |
| [`listPresets`](/pt/developer/api-reference/presets-api/#listpresets)       | Recupera uma lista de predefinições criadas para o aplicativo.                                              |
| [`deletePreset`](/pt/developer/api-reference/presets-api#deletepreset)      | Exclui uma predefinição da sua conta.                                                           |


## API de Dispositivo

|                <div style="width:250px"></div>                                               |                                                                                                    |
|-------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|
| [`registerDevice`](/pt/developer/api-reference/device-api#registerdevice)   | Registra um dispositivo para o aplicativo.                                                                         |
| [`unregisterDevice`](/pt/developer/api-reference/device-api#unregisterdevice) | Remove o token de push do dispositivo.                                                                               |
| [`deleteDevice`](/pt/developer/api-reference/device-api#deletedevice) | Exclui um dispositivo e todos os seus dados associados no aplicativo especificado.                                           |
| [`setTags`](/pt/developer/api-reference/device-api#settags)                 | Define os valores das tags para o dispositivo.                                                                                |
| [`getTags`](/pt/developer/api-reference/device-api#gettags)                 | Recupera as tags com seus valores correspondentes para um dispositivo específico.                                           |
| [`setBadge`](/pt/developer/api-reference/device-api#setbadge)               | Envia o valor atual do badge de um dispositivo para a Pushwoosh.                                                        |
| [`applicationOpen`](/pt/developer/api-reference/device-api#applicationopen)  | Registra um evento de abertura de aplicativo.                                                                                    |
| [`pushStat`](/pt/developer/api-reference/device-api#pushstat)               | Registra um evento de abertura de push.                                                                                    |
| [`messageDeliveryEvent`](/pt/developer/api-reference/device-api#messagedeliveryevent) | Registra um evento de entrega de push para o dispositivo.                                                      |

## API de Público

|    <div style="width:250px"></div>                                                            |                                                                                                     |
|-------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|
| [`bulkSetTags`](/pt/developer/api-reference/audience-api/#bulksettags) |         Define os valores das tags para vários dispositivos.                                                               |
| [`bulkSetTags Status`](/pt/developer/api-reference/audience-api/#bulksettags-status) | Retorna o status da operação bulkSetTags.  |
| [`bulkRegisterDevice`](/pt/developer/api-reference/audience-api/#bulkregisterdevice)   |     Registra vários dispositivos em uma única solicitação, incluindo valores de tag opcionais para cada dispositivo. |
| [`bulkRegisterDevice Status`](/pt/developer/api-reference/audience-api/#bulkregisterdevice-status)   |     Recupera o status e os resultados de uma solicitação de registro de dispositivo em massa usando um ID de solicitação. |
| [`bulkUnregisterDevice`](/pt/developer/api-reference/audience-api/#bulkunregisterdevice)   |     Cancela o registro de vários dispositivos em uma única solicitação.  |
| [`bulkUnregisterDevice Status`](/pt/developer/api-reference/audience-api/#bulkunregisterdevice-status)   |     Recupera o status e os resultados de uma solicitação de cancelamento de registro de dispositivo em massa usando um ID de solicitação.  |




## API de Tags

|                       <div style="width:250px"></div>                                         |                                                                                 |
|----------------------------------------------------------------------|----------------------------------------------------------------------------------------------|
| [`addTag`](/pt/developer/api-reference/tags#addtag)                      | Cria uma tag em sua conta.                                                              |
| [`deleteTag`](/pt/developer/api-reference/tags#deletetag)                | Remove uma tag com todas as informações associadas.                                              |
| [`listTags`](/pt/developer/api-reference/tags#listtags)                  | Recupera uma lista de tags na conta.                                                    |                                      |



## API de Segmentação (Filtros)

|                         <div style="width:250px"></div>                                       |                                                                                              |
|-------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------|
| [`createFilter`](/pt/developer/api-reference/segmentation-filters-api#createfilter) | Cria um novo segmento.                                                                     |
| [`listFilters`](/pt/developer/api-reference/segmentation-filters-api/#listfilters)  | Retorna uma lista de segmentos disponíveis com suas condições.                             |
| [`deleteFilter`](/pt/developer/api-reference/segmentation-filters-api#deletefilter) | Exclui um segmento existente.                                                             |
| [`exportSegment`](/pt/developer/api-reference/segmentation-filters-api#exportsegment) | Agenda uma solicitação para exportar assinantes que correspondem às condições do segmento.                  |
| [`exportSegment Results`](/pt/developer/api-reference/segmentation-filters-api#exportsegment-results) | Recupera o link CSV para os resultados de exportSegment.                           |



## API centrada no usuário

|                       <div style="width:250px"></div>                                           |                                                     |
|--------------------------------------------------------------------|----------------------------------------------------------------|
| [`registerUser`](/pt/developer/api-reference/user-centric-api#registeruser) | Associa um User ID externo a um dispositivo especificado.           |
| [`deleteUser`](/pt/developer/api-reference/user-centric-api#deleteuser) | Exclui um usuário e todos os dispositivos associados ao User ID especificado. |
| [`postEvent`](/pt/developer/api-reference/user-centric-api#postevent)  | Chama o evento dentro do aplicativo.                                |



## API de Eventos

|                        <div style="width:250px"></div>                                   |                          |
|------------------------------------------------------------------|--------------------------------------|
| [`createEvent`](/pt/developer/api-reference/events#createevent)       | Cria um evento para o aplicativo.        |



## API de Aplicativos

|                           <div style="width:250px"></div>                                               |                                                    |
|---------------------------------------------------------------------------|-----------------------------------------------------------------|
| [`createApplication`](/pt/developer/api-reference/applications#createapplication) | Cria um novo aplicativo na conta.                      |
| [`updateApplication`](/pt/developer/api-reference/applications#updateapplication) | Atualiza as configurações do aplicativo.                              |
| [`deleteApplication`](/pt/developer/api-reference/applications#deleteapplication) | Exclui o aplicativo da conta.                              |
| [`getApplication`](/pt/developer/api-reference/applications#getapplication)   | Obtém detalhes sobre o aplicativo.                                    |
| [`getApplications`](/pt/developer/api-reference/applications#getapplications) | Recupera uma lista de aplicativos na conta.              |
| [`getApplicationFile`](/pt/developer/api-reference/applications#getapplicationfile) | Recupera os arquivos de configuração relacionados ao aplicativo.         |
| [`setApplicationPlatformStatus`](/pt/developer/api-reference/applications#setapplicationplatformstatus) | Altera o status da plataforma do aplicativo. |


## API de Campanhas

|                            <div style="width:250px"></div>                                        |                           |
|-------------------------------------------------------------------|------------------------------------------|
| [`createCampaign`](/pt/developer/api-reference/campaigns#createcampaign) | Cria uma nova campanha de push.            |
| [`deleteCampaign`](/pt/developer/api-reference/campaigns#deletecampaign) | Exclui uma campanha específica.          |
| [`getCampaigns`](/pt/developer/api-reference/campaigns#getcampaigns)   | Recupera uma lista de campanhas para o aplicativo. |



## API de configuração de aplicativo

|    <div style="width:250px"></div>                      |                                                                                              |
|----------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
| [`configureApplication for iOS`](/pt/developer/api-reference/app-configuration#configureapplication-for-ios)         | Configura a plataforma iOS para o aplicativo.                                                                         |
| [`configureApplication for Android`](/pt/developer/api-reference/app-configuration#configureapplication-for-android) | Configura a plataforma Android para o aplicativo.                                                                     |
| [`configureApplication for Mac OS X`](/pt/developer/api-reference/app-configuration#configureapplication-for-mac-os-x) | Configura a plataforma macOS para o aplicativo.                                                                       |
| [`configureApplication for Windows`](/pt/developer/api-reference/app-configuration#configureapplication-for-windows) | Configura a plataforma Windows para o aplicativo.                                                                     |
| [`configureApplication for Amazon`](/pt/developer/api-reference/app-configuration#configureapplication-for-amazon)   | Configura a plataforma Amazon para o aplicativo.                                                                      |
| [`configureApplication for Chrome`](/pt/developer/api-reference/app-configuration#configureapplication-for-chrome)   | Configura a plataforma Chrome para o aplicativo.                                                                      |
| [`configureApplication for Safari`](/pt/developer/api-reference/app-configuration#configureapplication-for-safari)   | Configura a plataforma Safari para o aplicativo.                                                                      |
| [`configureApplication for Firefox`](/pt/developer/api-reference/app-configuration#configureapplication-for-firefox) | Configura a plataforma Firefox para o aplicativo.                                                                     |
| [`configureApplication for Email`](/pt/developer/api-reference/app-configuration#configureapplication-for-email)     | Configura a plataforma de E-mail para o aplicativo.                                                                       |



## API de E-mail

|                  <div style="width:250px"></div>                      |                                                                                                |
|----------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
| [`createEmailMessage`](/pt/developer/api-reference/email-api#createemailmessage) <Badge text="Obsoleto" variant="caution" size="small" /> | Cria uma mensagem de e-mail. Use [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/) com `platforms: ["EMAIL"]` e um [`email_payload`](/pt/developer/api-reference/messaging-api-v2/email-payload-reference/) em vez disso. |
| [`registerEmail`](/pt/developer/api-reference/email-api#registeremail)           | Registra um endereço de e-mail para o aplicativo.                                                                          |
| [`deleteEmail`](/pt/developer/api-reference/email-api#deleteemail)               | Remove um endereço de e-mail do seu banco de dados.                                                                     |
| [`setEmailTags`](/pt/developer/api-reference/email-api#setemailtags)             | Define os valores das tags para o endereço de e-mail especificado.                                                                 |
| [`registerEmailUser`](/pt/developer/api-reference/email-api#registeremailuser)   | Associa um User ID externo a um endereço de e-mail especificado.                                                   |



## API de dispositivos de teste

|                <div style="width:250px"></div>                       |                                                                                                |
|----------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
| [`createTestDevice`](/pt/developer/api-reference/test-devices#createtestdevice)  | Registra um dispositivo de teste para o aplicativo.                                                                     |
| [`listTestDevices`](/pt/developer/api-reference/test-devices#listtestdevices)    | Recupera todos os dispositivos de teste registrados para o aplicativo.                                                       |



## API da caixa de entrada de mensagens

|                <div style="width:250px"></div>                       |                                                                                                 |
|------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
| [`getInboxMessages`](/pt/developer/api-reference/message-inbox/#getinboxmessages) | Recupera a lista de mensagens da Caixa de Entrada para um HWID especificado.                                                       |
| [`inboxStatus`](/pt/developer/api-reference/message-inbox#inboxstatus)             | Atualiza o status de uma mensagem específica da Caixa de Entrada.                                                                  |



## API de Estatísticas
### Estatísticas de mensagens
|     <div style="width:250px"></div>  |  |
|----------------------------------------------|--------------------------------------------------------------------------------------------------|
| [`messages:list`](/pt/developer/api-reference/statistics-api/message-statistics-api/#messageslist) | Recupera uma lista de mensagens enviadas. |
| [`totalsByIntervals`](/pt/developer/api-reference/statistics-api/message-statistics-api/#totalsbyintervals) | Fornece métricas e dados de conversão agregados por hora. |
| [`getMessageLog`](/pt/developer/api-reference/statistics-api/message-statistics-api/#getmessagelog) | Recupera informações detalhadas sobre as mensagens enviadas. |
| [`linksInteractions`](/pt/developer/api-reference/statistics-api/message-statistics-api/#emailslinksinteractions) | Fornece estatísticas sobre cliques em links de e-mail. |
| [`linksInteractionsDevices`](/pt/developer/api-reference/statistics-api/message-statistics-api/#emailslinksinteractionsdevices) | Lista os usuários que clicaram em links nos e-mails. |
| [`bouncedEmails`](/pt/developer/api-reference/statistics-api/message-statistics-api/#bouncedemails) | Fornece informações sobre bounces de e-mail, reclamações e motivos de bounce. |

### Estatísticas de aplicativos e assinantes
|      <div style="width:250px"></div>  |  |
|----------------------------------------------|--------------------------------------------------------------------------------------------------|
| [`getApplicationSubscribersStats`](/pt/developer/api-reference/statistics-api/application-subscriber-statistics/#getapplicationsubscribersstats) | Recupera as estatísticas de assinantes do aplicativo, agrupadas por tipo de dispositivo. |
| [`getAppStats`](/pt/developer/api-reference/statistics-api/application-subscriber-statistics/#getappstats) | Recupera as estatísticas do aplicativo para um período de tempo específico. |
| [`getSubscribersStatistics`](/pt/developer/api-reference/statistics-api/application-subscriber-statistics/#getsubscribersstatistics) | Recupera as estatísticas de assinantes para um período de tempo específico. |

### Estatísticas de campanhas
|     <div style="width:250px"></div>   |  |
|----------------------------------------------|--------------------------------------------------------------------------------------------------|
| [`getCampaignStats`](/pt/developer/api-reference/statistics-api/campaign-statistics/) | Recupera as estatísticas da campanha para um período de tempo específico. |

### Estatísticas de eventos e tags
|     <div style="width:250px"></div>   |  |
|----------------------------------------------|--------------------------------------------------------------------------------------------------|
| [`getEventStatistics`](/pt/developer/api-reference/statistics-api/events-and-tags-statistics/#geteventstatistics) | Recupera o número de vezes que um evento foi acionado durante um período específico. |
| [`getTagStats`](/pt/developer/api-reference/statistics-api/events-and-tags-statistics/#gettagstats) | Recupera estatísticas para uma tag específica. |


## API de Atividades ao Vivo do iOS

|                <div style="width:250px"></div>                 |                                                                                             |
|------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
| [`startLiveActivity`](/pt/developer/api-reference/ios-live-activities-api#startliveactivity) | Cria uma nova Atividade ao Vivo do iOS.                                                                                 |
| [`updateLiveActivity`](/pt/developer/api-reference/ios-live-activities-api#updateliveactivity) | Atualiza uma Atividade ao Vivo do iOS existente.                                                                           |


## API Apple Wallet PassKit

|                <div style="width:250px"></div>                 |                                                                                             |
|------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
| [`API Apple Wallet PassKit`](/pt/developer/api-reference/apple-wallet-passkit-api/) | Referência para gerenciar passes do Apple Wallet e configurações relacionadas na Pushwoosh. |


## API do Google Wallet

|                <div style="width:250px"></div>                 |                                                                                             |
|------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
| [`Create a pass`](/pt/developer/api-reference/google-wallet-api/#create-a-pass) | Cria o passe no Google Wallet e retorna um link para salvar. |
| [`Validate a pass`](/pt/developer/api-reference/google-wallet-api/#validate-a-pass) | Verifica a configuração de um passe sem criá-lo. |
| [`Update a pass`](/pt/developer/api-reference/google-wallet-api/#update-a-pass) | Atualiza um passe existente. O Google entrega a alteração aos dispositivos salvos. |
| [`Get a save link`](/pt/developer/api-reference/google-wallet-api/#get-a-save-link) | Retorna um link "Adicionar ao Google Wallet" para um passe existente. |
| [`Get a pass`](/pt/developer/api-reference/google-wallet-api/#get-a-pass) | Retorna um único passe armazenado. |
| [`List passes`](/pt/developer/api-reference/google-wallet-api/#list-passes) | Retorna uma lista paginada de passes para um aplicativo. |
| [`Set pass state`](/pt/developer/api-reference/google-wallet-api/#set-pass-state) | Ativa ou invalida um passe. |
| [`Delete a pass`](/pt/developer/api-reference/google-wallet-api/#delete-a-pass) | Invalida o passe no Google e remove seu registro na Pushwoosh. |
| [`Get configuration`](/pt/developer/api-reference/google-wallet-api/#get-configuration) | Retorna o estado da configuração do Google Wallet para um aplicativo. |
| [`Templates`](/pt/developer/api-reference/google-wallet-api/#templates) | Lista modelos de passe ou busca um como ponto de partida. |


## API da Jornada do Cliente

|                          <div style="width:250px"></div>                                                             |                                    |
|------------------------------------------------------------------------------------------|--------------------------------------------------|
| [`Lifecycle`](/pt/developer/api-reference/customer-journey-api/lifecycle/) | Inicia, pausa, finaliza, rascunha ou arquiva uma jornada por seu UUID. |
| [`Create and update`](/pt/developer/api-reference/customer-journey-api/create-update/) | Cria uma nova definição de jornada ou substitui uma existente. |
| [`Start by API`](/pt/developer/api-reference/customer-journey-api/start-by-api/) | Injeta usuários no ponto de entrada da API de uma jornada em execução. |
| [`Get Journey stats`](/pt/developer/api-reference/customer-journey-api/statistics/) | Obtém estatísticas para uma jornada específica por seu ID. |
| [`Remove users from journeys`](/pt/developer/api-reference/customer-journey-api/drop-users/) | Remove um ou mais usuários de todas ou de jornadas ativas selecionadas. |


## API de solicitações agendadas

|                        <div style="width:250px"></div>                                |                                     |
|--------------------------------------------------------------|--------------------------------------------------|
| [`getResults`](/pt/developer/api-reference/scheduled-requests#getresults) | Recupera o resultado de uma solicitação agendada.    |



## API de SMS

|                      <div style="width:250px"></div>                                        |                  |
|-------------------------------------------------------------------|-------------------------------|
| [`createSMSMessage`](/pt/developer/api-reference/sms#createsmsmessage) <Badge text="Obsoleto" variant="caution" size="small" /> | Cria uma nova mensagem SMS. Use [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/) com `platforms: ["SMS"]` em vez disso. |



## API do WhatsApp

|                 <div style="width:250px"></div>                      |                                                                                              |
|----------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
| [`createWhatsAppMessage`](/pt/developer/api-reference/whatsapp#createwhatsappmessage) <Badge text="Obsoleto" variant="caution" size="small" /> | Cria uma nova mensagem do WhatsApp. Use [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/) com `platforms: ["WHATS_APP"]` em vez disso. |

## API do LINE

|                 <div style="width:250px"></div>                      |                                                                                              |
|----------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
| [`createLineMessage`](/pt/developer/api-reference/line-api/) <Badge text="Obsoleto" variant="caution" size="small" /> | Cria uma nova mensagem LINE. Use [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/) com `platforms: ["LINE"]` em vez disso. |

## API do Kakao

|                 <div style="width:250px"></div>                      |                                                                                              |
|----------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
| [`createKakaoMessage`](/pt/developer/api-reference/kakao/#createkakaomessage) <Badge text="Obsoleto" variant="caution" size="small" /> | Envia uma mensagem Kakao usando um modelo aprovado. Use [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/) com `platforms: ["KAKAO"]` em vez disso. |

## API de Geozones

|  <div style="width:250px"></div>           |  |
|-------------------------|-------------|
| [`getNearestZone`](/pt/developer/api-reference/geozones#getnearestzone) | Recupera os parâmetros da geozone mais próxima e a distância até ela. Também registra a localização do dispositivo para notificações push geográficas. |
| [`addGeoZone`](/pt/developer/api-reference/geozones#addgeozone) | Adiciona uma Geozone a um aplicativo específico. |
| [`updateGeoZone`](/pt/developer/api-reference/geozones#updategeozone) | Atualiza as propriedades da Geozone, como nome, status, conteúdo e alcance. |
| [`deleteGeoZone`](/pt/developer/api-reference/geozones#deletegeozone) | Remove Geozones do aplicativo. |
| [`addGeoZoneCluster`](/pt/developer/api-reference/geozones#addgeozonecluster) | Adiciona um Cluster de Geozone ao aplicativo. |
| [`deleteGeoZoneCluster`](/pt/developer/api-reference/geozones#deletegeozonecluster) | Remove um Cluster de Geozone do aplicativo. |
| [`listGeoZones`](/pt/developer/api-reference/geozones#listgeozones) | Recupera uma lista de Geozones para o aplicativo. |
| [`listGeoZoneClusters`](/pt/developer/api-reference/geozones#listgeozoneclusters) | Recupera uma lista de clusters de Geozone para o aplicativo. |