[pt-br] Implementação de campanhas utilizando Action Network API (OSDI)

[igr-santos]

Referências

Open Supporter Data Interface: API e estrutura de dados que visa garantir a interoperabilidade entre produtos no mercado progressivo, baseado em causas e campanhas sem fins lucrativos.

Contexto

Após adicionar a plataforma Action Network no escopo de tecnologias usadas no Bonde, foram testadas diversas formas de uso que garantissem o pleno funcionamento da estrutura de ação desenvolvida para o Bonde em conjunto com a estrutura de ação adotada pela Action Network. Por serem ferramentas que estão no mesmo escopo de atuação a tradução dos modelos entre as plataformas foi bem simples, chegando ao seguinte resultado:

Termo usado no Bonde	Termo usado na Action Network (OSDI)
Comunidade	Group
Mobilização e Widget	Campaign
Ativista	Person
Formulário	Form
Doções	Fundraiser page
Pressão	Letter campaign

Após aprofundar um pouco mais na documentação, vimos que o uso da plataforma Action Network acontece em duas instancias diferentes, uma chamada de Interface e outra de API, e que essas duas instancias não conseguem operar em conjunto no nível de criação e manutenção dos dados mas apenas no nível de consulta.

---

NOTE: Forms created via the API in this way are not equivalent to forms created with our user interface. API-created forms will not show up in lists of all of your actions on your dashboard of group page, they will not be given a URL on actionnetwork.org where people can sign, they will not have individual manage pages for statistics and submission downloads, and they will not send autoresponses. Rather, once they have at least one submission, they will show up as actions available for selection in our targeting interface, allowing you to select all people who have taken action on that form for reports or email targeting.

Trecho retirado da documentação do recurso de formulário

---

Ou seja, quando decidimos operar ações dentro do escopo do Bonde, ou qualquer outra tecnologia que visa implementar a maneira de criar e submeter uma ação, abrimos mão de utilizar algumas funcionalidades da Interface Action Network.

Proposta

Criar uma Interface API que implemente apenas as lógicas da ação e garante a integração da estrutura de dados com a Action Network. Como um espelho, os modelos devem permitir o acesso de ponta a ponta entre a Interface API Local e a API Action Network garantido o conceito de interoperabilidade entre sistemas obtido com uso da estrutura OSDI.