Planos e complementos

Planos de Listings e Social, itens inclusos, preços dos complementos, cobrança proporcional e limites de crescimento de contas de autoatendimento.

A Listings API vende dois produtos. Listings gerencia locais de empresas e sua presença em diretórios. Social gerencia marcas e publica nas contas sociais delas. Eles têm preços separados, cobranças separadas e limites separados.

Listings

Os níveis dos planos de Listings têm preços definidos pelo número de locais que você pode ter.

Cada local do plano tem acesso à rede completa de diretórios, ao gerenciamento de avaliações, às publicações e às análises. O nível altera quantos locais você pode ter e sua cota de requisições, mas não quais endpoints você pode chamar.

Social

Os níveis dos planos de Social têm preços definidos pelo número de conexões que você pode ter. Uma conexão é uma conta social — uma Página do Facebook, uma conta empresarial do Instagram, uma conta do X, uma organização do LinkedIn, uma pasta do Pinterest — vinculada a uma marca em uma rede por meio de um link de conexão.

As marcas são ilimitadas e não entram na medição de uso em nenhum nível. Uma marca é apenas o contêiner ao qual pertencem as contas conectadas e as publicações feitas por elas; criar uma não custa nada e nunca é impedido por um limite. POST /social/brands não tem limite de marcas em um plano de API.

O que você compra são conexões. As cinco redes compatíveis fazem com que uma marca totalmente conectada consuma cinco conexões, então 20 conexões correspondem a aproximadamente quatro marcas conectadas em todas as redes, e 125 correspondem a aproximadamente vinte e cinco — mas nada obriga você a seguir essa distribuição. Você pode distribuir 125 conexões entre sessenta marcas em duas redes cada ou concentrá-las em poucas marcas.

Complementos

Os complementos têm preços publicados e podem ser comprados a qualquer momento, sem mudar de nível.

Os pacotes de conexões são cumulativos. Eles são comprados por quantidade, então dois pacotes custam $50/mês por 10 conexões extras, três custam $75/mês por 15, e assim por diante. Não há complemento por marca nem como comprar uma única conexão: a unidade de compra é de cinco. Um pacote não tem tipo definido: ele adiciona cinco conexões ao total disponível, e você decide para quais redes e marcas elas vão.

As conexões formam um conjunto compartilhado por toda a conta

As conexões não são alocadas por marca. Seu nível e seus pacotes se somam em um único conjunto compartilhado por toda a conta, que qualquer marca pode usar:

maxConnections = tier connections + (5 × connection packs)

No Social Growth com dois pacotes, uma conta tem 125 + 10 = 135 conexões disponíveis, e uma marca pode ocupar 12 delas enquanto outra ocupa 1. Não há limite de conexões por marca — apenas o conjunto compartilhado.

Uma vaga é consumida por todo o período de cobrança, não apenas enquanto a conexão está ativa. O uso do conjunto é medido pelas conexões distintas que uma conta utilizou durante o período atual, portanto, desconectar um canal o coloca offline imediatamente, mas mantém sua vaga consumida até a renovação do período. Essa é a mesma regra aplicada a qualquer outra redução na conta — veja Cobrança proporcional — e significa que o conjunto não pode ser reutilizado dentro de um ciclo: conecte 20, desconecte todas, e você continuará com 20 até a renovação.

Disso decorrem duas coisas. Vincular novamente a mesma conta de rede social à mesma marca é gratuito, porque reutiliza a vaga que essa conta já ocupa nessa marca. Uma vaga pertence a um par de marca e conta, portanto, vincular a mesma conta a uma marca diferente consome uma segunda vaga, e a primeira permanece ocupada até o início do próximo ciclo. Além disso, comprar um pacote é a única forma de adicionar capacidade durante o período, pois os complementos são cobrados e disponibilizados imediatamente, enquanto as vagas liberadas aguardam o início do próximo ciclo.

GET /social/limits apresenta o panorama completo:

A capacidade restante é maxConnections - usage.connections. Quando o conjunto se esgota, o link de conexão retorna SY95042 — por isso, um desenvolvedor que acabou de desconectar várias contas ainda pode ter uma conexão recusada. A criação de marcas não tem falha equivalente em um plano de API.

Limites do autoatendimento

Dois limites máximos se aplicam, independentemente de quantos complementos sejam comprados:

• 100 locais em uma conta do Listings de autoatendimento.
• 250 conexões em uma conta do Social de autoatendimento.

Não há limite de marcas: as marcas são ilimitadas, e uma conta pode ter quantas quiser, desde que as conexões usadas por essas marcas permaneçam dentro do conjunto disponível.

Para ultrapassar qualquer um desses limites, a conta precisa migrar para o Enterprise, no qual os limites são negociados — entre em contato com a equipe de vendas em vez de comprar mais pacotes. Uma conta sem nenhum plano do Listings não pode criar locais e recebe SY10155; o equivalente para o Social é simplesmente não ter uma assinatura do Social, caso em que todos os endpoints /social/* ficam indisponíveis.

Como adicionar o segundo produto

Uma conta que tem um produto pode comprar o outro pelo painel, sem falar com a equipe de vendas e sem criar uma nova conta. Cada produto mantém sua própria assinatura, sua própria data de renovação e seu próprio cancelamento, exatamente como se você os tivesse comprado separadamente.

Cada produto tem seu próprio período de teste gratuito. O nível Launch de um produto que você nunca teve começa com 14 dias grátis, mesmo que você já seja cliente pagante do outro produto. Um cliente do Listings Growth que adiciona o Social Launch recebe os 14 dias do próprio Social, com sua própria data de renovação, e a cobrança do Listings continua sem alterações. O mesmo vale no sentido inverso para um cliente do Social que adiciona o Listings Launch.

Todos os níveis acima do Launch são cobrados no dia da compra, e o escopo do Enterprise para qualquer um dos produtos é definido conosco, em vez de ser vendido por autoatendimento.

O teste é oferecido uma única vez por produto. Se você já fez um teste de um produto, comprá-lo novamente gera uma cobrança imediata — não há um segundo período gratuito para o mesmo produto. Comprar um complemento enquanto uma assinatura ainda está em teste encerra esse teste e inicia a cobrança paga, o que o painel confirma antes que aconteça.

Cobrança proporcional

Os complementos são cobrados imediatamente. A compra de um local extra ou de um pacote de conexões entra em vigor imediatamente e é faturada na hora, com valor proporcional ao restante do ciclo de cobrança atual. Você não precisa esperar o início do próximo ciclo para usar a capacidade que acabou de comprar.

As reduções entram em vigor no fim do ciclo de cobrança. Nenhum recurso do qual você abrir mão gera reembolso pelo restante do período nem libera capacidade antes do encerramento do ciclo. Esta única regra abrange todas as reduções em qualquer um dos produtos:

Assim, uma vaga de conexão liberada se comporta exatamente como um complemento cancelado: o efeito ocorre no encerramento do período, e não na chamada à API. Enquanto você espera, ela é informada como usage.connectionsReleased em GET /social/limits, que é a sua previsão da capacidade que voltará a ficar disponível.

Essa assimetria é intencional: você sempre pode aumentar a capacidade imediatamente e pagar exatamente pelo que usou, e nunca perde a capacidade pela qual já pagou — nem a reutiliza duas vezes no mesmo período.

A regra de permanência mínima de 90 dias

Um local ou uma marca precisa ter sido criado há pelo menos 90 dias para poder ser arquivado. Tanto POST /locations/archive quanto POST /social/brands/archive aplicam essa regra; o endpoint de marcas a informa como status: "TENURE_NOT_MET" com SY95051.

A regra existe porque o arquivamento é o mecanismo de redução de uma assinatura e, sem ela, um recurso criado e arquivado dentro de um mesmo ciclo não teria custo algum. Ela tem uma consequência prática que você deve considerar ao projetar sua solução: uma marca ou um local criado por engano não pode ser removido por 90 dias. Valide antes de criar.

O que acontece depois que o prazo mínimo de permanência é cumprido varia conforme o produto:

• As marcas são arquivadas imediatamente, mas suas vagas de conexão não voltam a ficar disponíveis de imediato. A marca e todas as conexões vinculadas a ela são arquivadas na mesma solicitação e ficam offline imediatamente; cada uma dessas vagas fica então retida até o fim do ciclo de cobrança, exatamente como ocorreria em uma desconexão direta. GET /social/limits mostra a queda em usage.connectionsActive e o aumento correspondente em usage.connectionsReleased na próxima leitura, com o valor faturável de usage.connections inalterado até a renovação. O arquivamento em si não tem um estado agendado nem algo que possa ser cancelado.
• O arquivamento dos locais é agendado para o fim do ciclo de cobrança. O local permanece ativo e continua contando para o seu limite do Listings até o encerramento do ciclo, e a decisão pode ser revertida até esse momento com cancelar o arquivamento de um local.

Como consultar seus próprios limites

Verifique o limite relevante antes de uma operação de criação, em vez de depois de uma falha: isso permite mostrar ao cliente uma opção de upgrade em vez de um código de erro.