Uma das funcionalidades mais desejadas para o Zapt.In é uma integração maior com o Twitter. Claro que isto pode significar muitas coisas, mas para nós, estamos pensando em três categorias de integrações: a) integração com clientes do Twitter para que pessoas usando aplicativos como Twitterrifc, Tweetie, Echofon e outros possam utilizar o Zapt.In diretamente destes aplicativos; b) integração do site do Zapt.In com o Twitter para que seja mais simples compartilhar links do Zapt.In através do Twitter (como faz o Bit.Ly); e c) integração com o Twitter para monitorar quais os links mais tuitados e re-tuitados pelos usuários (como faz o Migre.Me).

Estou correndo para garantir que estas três categorias de integrações aconteçam, mas infelizmente, não tenho como fazê-las ao mesmo tempo e, no caso da integração com aplicativos, não tenho poder para fazê-la sozinho (preciso da colaboração dos seus respectivos desenvolvedores).

Mas o legal é que a integração do site do Zapt.In com o Twitter já foi concluída e está disponível para você. Ela utiliza a tecnologia OAuth (veja também a FAQ do Twitter sobre OAuth) e permite que você associe sua conta do Twitter a sua conta do Zapt.In, sem ter que fornecer seu login e senha do Twitter. OAuth é uma das maneiras mais seguras de integração de serviços na rede.

Bom, mas chega de “bla-bla-bla” e vamos ao que interessa: integrar sua conta do Zapt.In com o seu Twitter:

1. Encurte um LINK através do Zapt.In

Basta digitar uma URL ou usar nosso Bookmarklet.

2. Clique no botão “Compartilhar”

Para compartilhar um link pelo Twitter, basta clicar no botão “Compartilhar” de qualquer link que você vir no Zapt.in.

Se você ainda não tiver associado sua conta do Zapt.In à sua conta do Twitter, você verá a seguinte mensagem:

Clicando no link indicado, você será redirecionado para uma página do Twitter, onde poderá autorizar o Zapt.In a usá-lo em seu nome, de maneira segura.

3. Autorizando o Zapt.In a se conectar ao seu Twitter

Ao clicar no link, você será redirecionado para uma página do Twitter, onde você será questionado se deseja autorizar a associação da sua conta ao Zapt.In ou não. Clique no botão “Allow” (Permitir).

Verifique se a conta que você está associando ao Zapt.In é realmente a conta que você deseja autorizar. Se não for, clique na opção “Sign out” (Sair) e siga as instruções.

4. Pronto, agora é só compartilhar seus links

Quando você autorizar o Zapt.In a utilizar sua conta do Twitter, você será redirecionado de volta ao Zapt.In e estará pronto para compartilhar seus links diretamente, a partir do site do Zapt.In.

Quando sua conta estiver autorizada, ao clicar no botão “Compartilhar“, surgirá um pequeno formulário para escrever sua mensagem (tweet) e enviá-la através do Twitter.

Para sua comodidade, o link curto já estará dentro do campo da mensagem, mas você poderá customizá-la como quiser. Observe que existe um contador de quantos caracteres  ainda restam (lembrando que o máximo permitido pelo Twitter são 140 caracteres).

Com sua mensagem devidamente preparada, basta clicar no botão “Enviar Tweet“, que o tweet será enviado em seu nome. Veja um exemplo de como ficará a mensagem enviada através do Zapt.In:

É isto, boas tuitadas!!!

Olá, no último post falei de um novo projeto que coloquei no ar, o Zapt.In, um encurtador de URLs brazuca (sim, mais um, hehe). E nos últimos dias liberei algumas novas funcionalidades no Zapt.In. A mais interessante delas é a versão inicial da API de Desenvolvimento do Zapt.In. Mas o tema deste post não é a API, mas sim como colocar o Zapt.In para funcionar no Tweetie, um dos melhores clientes do Twitter para iPhone.

Bom, mas chega de bla bla bla e vamos ao que interessa…

1. Conseguindo sua Chave da API do Zapt.In

Para utilizar a API do Zapt.In, você precisa pegar sua chave da API. Para isto faça seu login no Zapt.In e clique na opção “Perfil” do menu de usuário. Na página com informações de seu perfil você verá sua Chave da API.

2. Agora abra o Tweetie em seu iPhone

Teta, basta clicar no ícone do Tweetie em seu springboard:

3. Configure o Tweetie para usar o Zapt.In

Na tela inicial do Tweetie (para escolhar qual conta você vai usar), clique no botão “Settings” (configurações):

Depois clique na opção “URL Shortening” (encurtamento de URLs):

Depois escolha a opção “Custom” (Customizado) para configurar o Zapt.In:

Agora é colocar a URL da API do Zapt.In no campo de customização. A URL deve ficar da seguinte forma:

http://zapt.in/api/links/shorten?version=1.0&login=SEU_LOGIN&key=SUA_CHAVE&longUrl=%@

Não se esqueça de substituir os valores SEU_LOGIN e SUA_CHAVE pelos valores de sua conta no Zapt.In!!

Depois de colocar a URL clique no botão “save” (salvar) e você estará pronto para usar o Tweetie com o Zapt.In.

3. Agora é só usar…

Digite sua mensagem com uma URL longa que você deseja encurtar. Depois clique no botãozinho que fica no campo da mensagem com a contagem de caracteres:

Agora é só clicar no botão “Shrink URLs” (Comprimir URLs) e as URLs longas de sua mensagem serão magicamente encurtadas pelo Zapt.In:

Eeeeba… agora só faltam dois zilhões de outras aplicações suportarem o Zapt.in!!! ;-)

Nesta semana liberamos a implementação da API do Twitter que desenvolvemos e utilizamos no mais novo projeto da Webco, a Tuitersfera. Liberamos a API no GitHub com o nome de Tuiter (isto mesmo, Tuiter com TU, bem abrasileirado). Neste post farei um pequeno tutorial de introducão ao uso da Gem Tuiter para integrar sua aplicação com o Twitter.

Instalando a gema Tuiter

Se você ainda não adicionou o GitHub às suas fontes de gemas, execute o comando abaixo. Se já fez isto, pule este passo e vá direto para o comando seguinte para a instalação da gema.

1

% gem sources -a http://gems.github.com

Instalando a gema em seu computador:

1

% sudo gem install webco-tuiter

Testando a instalação

Para testar a instalação, basta você abrir o interpretador Ruby e executar os comandos abaixo. Utilize seu usuário do Twitter e sua senha na chamada que instancia a classe cliente da API. Se tudo der certo, o código deve apresentar a sua descrição (de seu perfil) no Twitter.

1
2
3
4
5
6
7
8

require 'rubygems'
require 'tuiter'
 
cli = Tuiter::Client.new(:username=>"seu_login", :password => "sua_senha")
 
voce = cli.get_user("seu_login")
 
puts voce.description

Todos os métodos de manipulação da API estão na classe Client.

Atualizando seu status no Twitter

Para atualizar seu status no Twitter basta usar o método update() da classe Client. Veja:

1
2
3
4
5
6

require 'rubygems'
require 'tuiter'
 
cli = Tuiter::Client.new(:username=>"seu_login", :password => "sua_senha")
 
cli.update("Olá mundo, estou no Twitter!!!")

Consultando seus @replies

Utilize o método get_replies() da classe Client. Este método trará os 20 últimos updates recebidos pelo usuário que você usou para inicializar a classe Client. Você pode pegar mais replies paginando os resultados, para isto basta passar o parâmetro page na chamada do método. O código abaixo mostrará seus 40 últimos replies:

1
2
3
4
5
6
7
8
9
10
11
12

require 'rubygems'
require 'tuiter'
 
cli = Tuiter::Client.new(:username=>"seu_login", :password => "sua_senha")
 
replies = []
replies |= cli.get_replies
replies |= cli.get_replies(:page => 2)
 
replies.each do |reply|
  puts "From #{reply.user.screen_name} @ #{reply.created_at.to_s} : #{reply.text}"
end

Enviando uma mensagem direta (direct)

Utilize o método direct_new() da classe Client. Os parâmetros são o id ou o login do usuário para quem você deseja enviar a mensagem e a mensagem a ser enviada. Veja:

1
2
3
4
5
6

require 'rubygems'
require 'tuiter'
 
cli = Tuiter::Client.new(:username=>"seu_login", :password => "sua_senha")
 
cli.direct_new("crisdias","olá cris, quanto vale um whuffie?")

Consultando dados de um usuário

Para isto você deve usar o método get_user da classe Client. O resultado é um objeto da classe ExtendedUser e ela contém métodos para consultar cada atributo de um usuário. Veja:

1
2
3
4
5
6
7
8
9
10
11
12
13
14

require 'rubygems'
require 'tuiter'
 
cli = Tuiter::Client.new(:username=>"seu_login", :password => "sua_senha")
 
edney = cli.get_user("interney")
 
puts edney.name  # Nome do usuário
puts edney.screen_name  # Login do usuário
puts edney.description  # Descrição do perfil do usuário
puts edney.url  # URL do perfil do usuário
puts edney.followers_count  # Quantidade de seguidores do usuário
puts edney.friends_count  # Quantidade de amigos (pessoas que ele segue) do usuário
puts edney.location  # Localização do perfil do usuário

Dicas finais

Existe um limite de utilização da API do Twitter para cada usuário. Este limite, normalmente, é de 100 requisições por hora. Então, cuidado para não estourar o limite, isto fará com que você não consiga interagir com o Twitter até acabar aquela hora. Este limite é chamado de Rate Limit e também pode ser consultado pela nossa implementação da API. Para isto utilize o método rate_limit da classe Client. O resultado é uma estrutura que traz dados sobre como anda seu limites de uso da API. Veja:

1
2
3
4
5
6
7
8

require 'rubygems'
require 'tuiter'
 
cli = Tuiter::Client.new(:username=>"seu_login", :password => "sua_senha")
 
cli.rate_limit
 
=> #<Tuiter::RateLimit:0x1802e3c @reset_window=2706.502303, @reset_time=Tue Mar 17 21:15:48 -0300 2009, @hourly_limit=100, @reset_time_in_seconds=Tue Mar 17 21:15:48 -0300 2009, @remaining_hits=84>

Observe que, no exemplo, ainda temos 84 requisições restantes (remaining_hits) até estourar o limite de uso da API na hora corrente. E ainda, a hora corrente acaba às 21:15 (reset_time) e ai teremos mais 100 requisições de limite.

A outra dica é consultar a documentação oficial da API do Twitter para entender melhor como ela funciona.

Colabore com nossa API

O projeto está hospedado no GitHub e qualquer um pode colaborar. Para entender melhor como isto pode acontecer, entre em contato com os desenvolvedores que estão cuidando dela (Luiz Rocha, Luis Cipriani e o Lucas Húngaro) através do email tuitersfera (arroba) webcointernet.com. Se você encontrar algum bug, tiver alguma sugestão ou desenvolver qualquer coisa legal com a API, também não deixe de avisar.

Boa Sorte e boas Tuitadas!!!

O Tuitersfera é um pequeno projeto que desenvolvi e lancei no começo de Fevereiro. Foram apenas alguns dias de trabalho com Ruby e Rails para montar um pequeno sistema interativo que integrava o Twitter com o Google Maps e que tinha o objetivo de mapear o uso do Twitter no Brasil.

A idéia era bem simples, bastava que os usuários do Twitter passassem a seguir o usuário @tuitersfera e, a partir dai, interagissem com ele através do website (http://tuitersfera.com.br) ou de mensagens diretas (directs) com comandos bem simples. Através destes comandos seria possível dizer para o Tuitersfera onde você vive, trabalha e também por onde você anda.

Em apenas 48 horas o Tuitersfera ultrapassou a marca de mais de 1000 usuários (seguidores). Infelizmente não tive tempo para continuar o desenvolvimento do projeto e ele acabou ficando meio largado. Mas isto já foi resolvido, três Jedis da WebCo (Luiz Rocha, Luis Cipriani e o Lucas Húngaro) adotaram o projeto e estarão trazendo várias novidades. O Tuitersfera deve se transformar numa plataforma interativa que oferecerá alguns serviços baseado no Twitter e também em outros serviços como o Google Maps. Claro, continuaremos com o propósito inicial de mapear o uso do Twitter do Brasil e também criar um ranking local dos tuiteiros de plantão.

Um sub-produto do projeto foi a implementação em Ruby de uma biblioteca que consome a API do Twitter. Fiz isto porque achei as outras implementações complicadas de usar ou incompletas. Eu e os novo pais adotivos do Tuitersfera resolvemos transformar esta biblioteca em uma gema (Ruby Gem) e liberá-la como um projeto Open Source. Em breve disponibilizaremos tudo no GitHub (isto deve acontecer nas próximas semanas).

Enquanto as novidades não chegam, você pode seguir o @tuitersfera e começar a interagir com ele. Para dizer onde você vive, basta enviar uma mensagem direta com o seguinte formato: moro em onde_você_vive

Você pode enviar seu endereço com a resolução que desejar, pode ser seu endereço completo, ou apenas a cidade onde você mora. O Tuitersfera se vira para entender o endereço. Veja alguns exemplos abaixo:

• moro em Avenida Paulista, 3333, São Paulo, SP, Brasil
• moro em Alamenda Santos, São Paulo, SP, Brasil
• moro em São Paulo, SP, Brasil

Bom, por enquanto é isto. Se você tiver dúvidas ou sugestões para o Tuitersfera, entre em contato com os pais adotivos do projeto.

E boas tuitadas!!!

A equipe do BlogBlogs lançou nesta sexta-feira (16.Jan.2009) o LiveStream do Campus Party 2009. O novo LiveStream conta com uma novíssima interface com várias opções de filtros e também um sistema de buscas. Existe também uma versão simplificada da interface para uso em computadores com tela menor (netbooks) e projetores. Esta é a versão Kiosk Mode e você pode vê-la aqui (LiveStream Kiosk Mode). Para aparecer no LiveStream basta subir seu conteúdo para os serviços suportados (BlogBlogs, Flickr, YouTube, VideoLog, PinFotos, Gozub, Gengibre, Brasigo e Twitter) utilizando a tag #cparty.

A versão padrão (uso em telas maiores) da interface pode ser vista abaixo: