Usar la API de Facebook, ¿por dónde comenzar?

Facebook va más allá de su portal e interacción entre los usuarios, ofrece realmente una plataforma completa con herramientas para desarrolladores donde se pueden hacer aplicaciones para la Web, móviles y Facebook. Estas aplicaciones ponen en servicio un sin fin de métodos y propiedades para que nuestras APPs o Webs puedan convertirse en potentes sistemas de marketing, mediante la recolección de datos y comportamientos de los usuarios.

La API está desarrollada con un extensa compatibilidad a la mayoría de los SDK actuales disponibles, PHP, JavaScript, Android e IOS SDK, ActionScript etc. También está disponible una cantidad básica de plugins para la interacción de nuestros sitios con Facebook en unos simples copy/paste!

El problema concreto que se presenta es que al ser tan extensa y al poseer tantas posibilidades a la hora de listar ventajas o a elegir “que lenguaje es el mas adecuado” se puede volver una tarea desalentadora.

Antes de comenzar, lo correcto sería responder una pequeña lista de preguntas para saber correctamente a que sección específica de la documentación nos deberíamos dirigir:

Quiero leer completamente toda la documentación sin importar el SDK que valla a utilizar: Es muy recomendable ver todo el repositorio de la documentación para tener una idea general de las posibilidades y acercarse mas a esto de las app para Facebook.

Quiero crear una app para mi Web o integrar mi pagina Web con funcionalidades de Facebook: En muchos casos vamos a querer relacionar Facebook y nuestra Web, por ejemplo desde colocar un liked buttom, a un login usando la cuenta de Facebook o hasta la necesidad de recuperar datos y preferencias específicas de un usuario para nuestra Web.

Quiero crear una app (Aplicación) para facebook: Crear aplicaciones dentro de facebook es uno de los recursos mas válidos para generar tráfico. Desde la posibilidad de crear juegos online, recabar datos, relacionar usuarios, crear interacciones como cyber bares, salas de reuniones virtuales o simplemente para promocionar un producto.

Quiero crear una app para un móvil, ya sea android o iOS (iphone): Finalmente también es posible crear aplicaciones nativas que no requieran usar un navegador Web. Muy útil si a una aplicación le queremos complementar recursos sociales o medias shares (compartir video, fotos y/o sonido).

Una vez entendido esta clasificación general, el siguiente paso es comenzar hacer uso de la API en el lenguaje más familiar.

Agregar una aplicación a una página de facebook (agregar pestaña)

Rev: 13/04/2012

Una vez lograda la configuración y puesta de nuestra aplicación, tendremos la necesidad de agregar o vincular esta app con nuestra pagina de facebook. Para agregar debemos invocar la siguiente url:
https://www.facebook.com/dialog/pagetab?app_id=YOUR_APP_ID&next=YOUR_URL

Donde  YOUR_APP_ID es la ID de la app [ ver imagen ] 1
Donde  YOUR_URL es la url del lienzo [ ver imagen ] 2

Indicar a que página se agregara la app [ ver imagen ]

Ver ejemplo funcionando, al entrar clic en la pestaña capitulo 1

Crear una aplicación para facebook, primeros pasos

Rev: 13/04/2012: Las app que no cuentan con un servidor seguro https están dejando de funcionar

Actualmente Facebook revoluciono la manera de comunicarse y de hacer presencia en la Web. En la actualidad no hay sitios sin la inclusión de redes sociales a sus notas o portal. Hasta alguno van mas allá, creando aplicaciones.

Cuando necesitamos hacer uso de la API de facebook o cualquiera sea, se nos presenta los requerimientos y metodologías propias de la misma mas allá del lenguaje a utilizar. Este es uno de los puntos donde el desarrollador deberá escrudiñar y resolver que métodos son los mejores, actuales y futuros para la aplicación a crear.

Facebook en la evolución de su plataforma fue presentando diferentes métodos de comunicación, los cuales en la actualidad aun viven todos por igual. Vale aclarar que por ejemplo el método FBML el cual consiste de la utilización de etiquetas para comunicarse con la plataforma de Facebook, no solo que esta desestimado sino que a partir de este año no es mas compatible con la API. Por esta razón Facebook alienta a usar su Graph API la cual innova en métodos y propiedades ya que la misma se basa en formato JSON logrando mayor compatibilidad con los lenguajes disponibles, como por ejemplo: JavaScript, PHP, ActionScript, .NET y la mayoría de lenguajes OOP.

Por esta razón es que la API de facebook en la mayoría de los casos se vuelve complicada, redundante y anti newbie para quienes dan sus primeros pasos. Es tanta las posibilidades, métodos y nuevos cambios que agregan que suele ser media tediosa. La idea de este mini tutorial es saltear los obstáculos innecesarios de investigación e ir directamente a la plataforma recomendada utilizando después de ahí en mas el lenguaje que mas común les sea.
En los siguientes tutoriales usaremos actionscript, javascript y algunos en php.

Para comenzar es importante listar que necesitamos:

  • Registrarnos o tener una cuenta de usuario de Facebook
  • Una vez identificado, registrarnos como desarrolladores en https://developers.facebook.com/ haciendo clic en “aplicaciones” [ver imagen].
  • La primera vez nos solicitara permiso para acceder a la información de nuestra cuenta [ver imagen]
  • Completado el permiso a nuestros datos hacemos clic en “crear aplicación” [ver imagen]
    Importante: se nos pedirá validar nuestra cuenta con un numero de móvil, deben cargar el numero de su teléfono móvil y esperar que la plataforma les envié un código de validación.
    Recuerden que si están en Argentina deben usar el dígito 9 para indicar que es un teléfono celular. Ejemplo: Argentina – Córdoba: 9 351 6252233 donde 9 es la característica que indica que es un celular, 351 es la característica de Córdoba, 6252233 el numero celular sin el prefijo 15. [ ver imagen ]
    – Una vez validado el número de teléfono, llenaremos los campos “Nombre para mostrar de la aplicación” y “Espacio de nombres de la aplicación“. En el primer campo colocare un nombre que describa nuestra aplicación, en el segundo campo un nombre exclusivo de nuestra app, este no puede tener espacios ni mayúsculas y finalmente aceptamos los términos de uso, luego presionamos continuar. [ ver imagen ]
  • Verificar si somos humanos mediante capcha [ ver imagen ]
  • Completado todos estos pasos, ya logramos tener nuestra primera aplicación, así mismo queda unos puntos mas a detallar para concluir con lo mínimos requerimientos para luego ya pasar a interactuar con la plataforma.
    Vease la imagen que el indicador A: es el id de la app que luego usaremos para interactuar con esta aplicación, cada aplicación tiene su único identificador. B: Este es el código secreto para la dicha app, en algunos casos se le requerirá este código.
    Dado el caso de que vamos a trabajar en pos de crear una app para facebook vamos a completar los siguientes campos:
    La información básica ya fue cargada previamente, aunque si se requiere se puede editar en esta etapa (1, 2, 3).
    En el apartado “Seleccione como tu aplicación se integra con Facebook” seleccionamos “Aplicación en Facebook” y completamos los campos siguientes:
    Canvas URL“: Aquí indicamos la url o dominio donde tenemos alojados nuestros archivos html, php, asp etc.
    URL segura de la página principal“: Aquí podemos colocar el mismo dominio que pusimos en el campo anterior y en la parte del protocolo http cambiarlo por “https”. [ ver imagen ]
  • Finalmente en el apartado “Pestaña de página” Colocamos un nombre, y nuevamente las url de nuestro canvas, siguiendo el mismo criterio que en el paso anterior, no olviden de donde pide url segura usar https [ ver imagen ]

PD: Fíjese que la ultima imagen difiere de las restante por los últimos cambios realizados por Facebook en su plataforma, así mismo los pasos anteriores siguen siendo validos para crear una app

Finalmente pudes ver aqui el resultado de todos estos pasos y de nuestra primera APP!